Inicio rápido: SDK de Azure Translator (traducción de texto)

En este inicio rápido, empiece a usar Translator para traducir texto mediante un lenguaje de programación que prefiera. Para este proyecto, se recomienda usar el plan de tarifa gratuito (F0), mientras se familiariza con la tecnología y, posteriormente, actualizarlo a un nivel de pago para producción.

Prerrequisitos

Necesita una suscripción de Azure activa. Si no tiene una suscripción, puede crear una gratis.

Una vez que haya creado la suscripción de Azure, cree un recurso de Translator en Azure Portal.
Después de implementar el recurso, seleccione el botón Ir al recurso para obtener la clave y el punto de conexión.
- Obtenga la clave, el punto de conexión y la región del recurso y conecte la aplicación a Translator. Pegue estos valores en el código más adelante, en el inicio rápido. Puede encontrarlos en la página Claves y punto de conexión de Azure Portal:

Configuración de un entorno de C#/.NET

En este inicio rápido, se va a usar la versión más reciente del IDE de Visual Studio para compilar y ejecutar la aplicación.

Inicie Visual Studio.
En la página Introducción, seleccione Crear un proyecto.
En la página Crear un proyecto, escriba consola en el cuadro de búsqueda. Elija la plantilla Aplicación de consola y, a continuación, seleccione Siguiente.
En la ventana de diálogo Configure su nuevo proyecto, escriba text-translation-sdk en el cuadro Nombre de proyecto. Después, haga clic en Siguiente.
En la ventana de diálogo Información adicional, seleccione .NET 6.0 (Compatibilidad a largo plazo) y, a continuación, seleccione Crear.

Instalación de la biblioteca cliente con NuGet

Haga clic con el botón derecho en el proyecto Translator-text-sdk y seleccione la opción Manage NuGet Packages...
Seleccione la Browse pestaña y la Include prerelease casilla y escriba Azure.AI.Translation.Text.
Seleccione la versión 1.0.0-beta.1 en el menú desplegable e instale el paquete en el proyecto.

Compilación de la aplicación

Para interactuar con Translator mediante la biblioteca cliente, debe crear una instancia de la TextTranslationClientclase . Para ello, creará un AzureKeyCredential con key de Azure Portal y una instancia de TextTranslationClient con el AzureKeyCredential. La autenticación varía ligeramente en función de si el recurso usa el punto de conexión regional o global. Para este proyecto, autentíquese mediante el punto de conexión global. Para más información sobre el uso de un punto de conexión regional, consulteSDK de texto de Translator.

Nota:

A partir de .NET 6, los nuevos proyectos que usan la plantilla console generan un nuevo estilo de programa que difiere de las versiones anteriores.
El nuevo tipo de salida usa características recientes de C# que simplifican el código que debe escribir.
Cuando se usa la versión más reciente, solo es necesario escribir el cuerpo del método Main. Es decir, no es necesario incluir instrucciones de nivel superior, directivas Using globales o directivas Using implícitas.
Para obtener más información, consulteLas nuevas plantillas de C# generan instrucciones de nivel superior.

Abra el archivo Program.cs.
Elimine el código existente, incluida la línea Console.WriteLine("Hello World!"), y escriba el ejemplo de código siguiente en el archivo Program.cs de la aplicación:

Ejemplo de código

Importante

Recuerde quitar la clave del código cuando haya terminado y no hacerla nunca pública. En el caso de producción, use una forma segura de almacenar sus credenciales y acceder a ellas, como Azure Key Vault. Para obtener más información, consulte Foundry Tools seguridad.

Traducir texto

Nota:

En este ejemplo, se usa el punto de conexión global. Si usa un punto de conexión regional, consulte Creación de un cliente de traducción de texto.


using Azure;
using Azure.AI.Translation.Text;


string key = "<your-key>";

AzureKeyCredential credential = new(key);
TextTranslationClient client = new(credential);

try
{
    string targetLanguage = "fr";
    string inputText = "This is a test.";

    Response<IReadOnlyList<TranslatedTextItem>> response = await client.TranslateAsync(targetLanguage, inputText).ConfigureAwait(false);
    IReadOnlyList<TranslatedTextItem> translations = response.Value;
    TranslatedTextItem translation = translations.FirstOrDefault();

    Console.WriteLine($"Detected languages of the input text: {translation?.DetectedLanguage?.Language} with score: {translation?.DetectedLanguage?.Score}.");
    Console.WriteLine($"Text was translated to: '{translation?.Translations?.FirstOrDefault().To}' and the result is: '{translation?.Translations?.FirstOrDefault()?.Text}'.");
}
catch (RequestFailedException exception)
{
    Console.WriteLine($"Error Code: {exception.ErrorCode}");
    Console.WriteLine($"Message: {exception.Message}");
}

Ejecución de la aplicación

Una vez que agregue una muestra de código a su aplicación, elija el botón verde Iniciar junto a formRecognizer_quickstart para crear y ejecutar su programa, o pulse F5.

Captura de pantalla: ejecución del programa en Visual Studio.

Este es un fragmento de la salida esperada:

Captura de pantalla de la salida de Visual Studio Code en la ventana de terminal.

Configuración del entorno Java

Nota:

El SDK de traducción de texto de Azure para Java se prueba y se admite en plataformas Windows, Linux y macOS. No se ha probado en otras plataformas y no admite implementaciones de Android.

En este inicio rápido, se usará la herramienta de automatización de compilaciones Gradle para crear y ejecutar la aplicación.

Debe tener instalada la versión más reciente de Visual Studio Code o del IDE que prefiera usar. ConsulteJava en Visual Studio Code.
Sugerencia
- Visual Studio Code ofrece un paquete de codificación para Java para Windows y macOS. El paquete de codificación es un conjunto de VS Code, el Kit de desarrollo de Java (JDK) y una colección de extensiones sugeridas por Microsoft. El paquete de codificación también se puede usar para corregir un entorno de desarrollo existente.
- Si usa VS Code y el paquete de codificación para Java, instale la extensión Gradle para Java.
Si no usa Visual Studio Code, asegúrese de que tiene lo siguiente instalado en el entorno de desarrollo:
- Java Development Kit (OpenJDK) en versión 8 o posterior.
- Gradle, versión 6.8 o posterior.

Creación de un proyecto de Gradle

En una ventana de consola (como CMD, PowerShell o Bash), cree un nuevo directorio para la aplicación que se llame text-translation-app y vaya hasta él.
```
mkdir text-translation-app && text-translation-app
```
```
mkdir text-translation-app; cd text-translation-app
```
Ejecute el comando gradle init desde el directorio text-translation-app. Este comando creará archivos de compilación esenciales para Gradle, como build.gradle.kts, que se usa en el entorno de ejecución para crear y configurar la aplicación.
```
gradle init --type basic
```
Cuando se le solicite que elija un DSL, seleccione Kotlin.
Acepte el nombre predeterminado del proyecto (text-translation-app). Para ello, presione la tecla INTRO o ENTRAR.

Nota:

Puede tardar unos minutos en crearse toda la aplicación, pero pronto debería ver varias carpetas y archivos, incluido build-gradle.kts.

Actualice build.gradle.kts con el código siguiente. La clase principal es Translate:

  plugins {
  java
  application
}
application {
  mainClass.set("Translate")
}
repositories {
  mavenCentral()
}
dependencies {
  implementation("com.azure:azure-ai-translation-text:1.0.0-beta.1")
}

Creación de una aplicación Java

En el directorio text-translation-app, ejecute el siguiente comando:
```
mkdir -p src/main/java
```
El comando crea la siguiente estructura de directorios:
Vaya al directorio java y cree un archivo denominado Translate.java.
Sugerencia
- Puede crear un nuevo archivo mediante PowerShell.
- Abra una ventana de PowerShell en el directorio del proyecto. Para ello, mantenga presionada la tecla Mayús y haga clic con el botón derecho en la carpeta.
- Introduzca el siguiente comando New-Item Translate.java.
- También puede crear un nuevo archivo en el IDE que se llame Translate.java y guardarlo en el directorio java.
Copie y pegue el siguiente ejemplo de código de traducción de texto en el archivo Translate.java.
- Actualice "<your-key>", "<your-endpoint>" y "<region>" con valores de la instancia de Translator del portal de Azure.

Ejemplo de código

Traducir texto

Importante

Nota:

En este ejemplo, se usa el punto de conexión global. Si usa un punto de conexión regional, consulte Creación de un cliente de traducción de texto.

import java.util.List;
import java.util.ArrayList;
import com.azure.ai.translation.text.models.*;
import com.azure.ai.translation.text.TextTranslationClientBuilder;
import com.azure.ai.translation.text.TextTranslationClient;

import com.azure.core.credential.AzureKeyCredential;
/**
 * Translate text from known source language to target language.
 */
public class Translate {

    public static void main(String[] args) {
        String apiKey = "<your-key>";
        AzureKeyCredential credential = new AzureKeyCredential(apiKey);

        TextTranslationClient client = new TextTranslationClientBuilder()
                .credential(credential)
                .buildClient();

        String from = "en";
        List<String> targetLanguages = new ArrayList<>();
        targetLanguages.add("es");
        List<InputTextItem> content = new ArrayList<>();
        content.add(new InputTextItem("This is a test."));

        List<TranslatedTextItem> translations = client.translate(targetLanguages, content, null, from, TextType.PLAIN, null, null, null, false, false, null, null, null, false);

        for (TranslatedTextItem translation : translations) {
            for (Translation textTranslation : translation.getTranslations()) {
                System.out.println("Text was translated to: '" + textTranslation.getTo() + "' and the result is: '" + textTranslation.getText() + "'.");
            }
        }
    }
}

Compilación y ejecución de la aplicación**

Una vez que agregue el ejemplo de código a la aplicación, vuelva al directorio principal del proyecto: text-translation-app.

Compile la aplicación con el comando build (debería recibir un mensaje COMPILACIÓN EXITOSA):
```
gradle build
```
Ejecute la aplicación con el comando run (debería recibir un mensaje COMPILACIÓN EXITOSA):
```
gradle run
```

Este es un fragmento de la salida esperada:

Captura de pantalla de la salida de Java en la ventana del terminal.

Configuración del entorno de Node.js

En este inicio rápido, usaremos el entorno de ejecución de JavaScript de Node.js para crear y ejecutar la aplicación.

Asegúrese de que tiene la versión más reciente de Node.js. La instalación de Node.js incluye el administrador de paquetes de nodos (npm).

Sugerencia

Si es la primera vez que usa Node.js, pruebe el módulo de Learn Introducción a Node.js.
En una ventana de consola (como CMD, PowerShell o Bash), cree un directorio para la aplicación que se llame text-translation-app y vaya a él.
```
mkdir text-translation-app && cd text-translation-app
```
```
mkdir text-translation-app; cd text-translation-app
```
Ejecute el comando "npm init" para inicializar la aplicación y aplicar la técnica scaffolding al proyecto.
```
npm init
```
Especifique los atributos del proyecto, para lo que debe aceptar las solicitudes que se presentan en el terminal.
- Los atributos más importantes son el nombre, el número de versión y el punto de entrada.
- Se recomienda mantener index.js para el nombre del punto de entrada. La descripción, el comando de prueba, el repositorio de GitHub, las palabras clave, el autor y la información de la licencia son atributos opcionales; se pueden omitir para este proyecto.
- Acepte las sugerencias entre paréntesis seleccionando Retorno o Entrar.
- Después de completar las indicaciones, se creará un package.json archivo en el directorio text-translation-app.

Instalación de la biblioteca cliente

Abra una ventana de terminal e instale la biblioteca cliente Azure Text translation para JavaScript con npm:

npm i @azure-rest/ai-translation-text@1.0.0-beta.1

Compilación de la aplicación

Para interactuar con Translator mediante la biblioteca cliente, debe crear una instancia de la TextTranslationClientclase . Para ello, creará un TranslateCredential con key y <region> desde Azure Portal y una instancia de TextTranslationClient. Para obtener más información, consulteSDK de texto de Translator.

Cree el archivo index.js en el directorio de la aplicación.
Sugerencia
- Puede crear un nuevo archivo mediante PowerShell.
- Abra una ventana de PowerShell en el directorio del proyecto. Para ello, mantenga presionada la tecla Mayús y haga clic con el botón derecho en la carpeta.
- Introduzca el siguiente comando New-Item index.js.
- También puede crear un nuevo archivo en el IDE que se llame index.js y guardarlo en el directorio text-translation-app.
Copie y pegue el siguiente ejemplo de código de traducción de texto en el archivo index.js. Actualice <your-endpoint> y <your-key> con los valores de la instancia de Translator de Azure Portal.

Ejemplo de código

Importante

Traducir texto

Nota:

En este ejemplo, se usa un punto de conexión regional. Si usa el punto de conexión global, consulte Creación de un cliente de traducción de texto.

const TextTranslationClient = require("@azure-rest/ai-translation-text").default

const apiKey = "<your-key>";
const endpoint = "<your-endpoint>";
const region = "<region>";

async function main() {

  console.log("== Text translation sample ==");

  const translateCredential = {
    key: apiKey,
    region,
  };
  const translationClient = new TextTranslationClient(endpoint,translateCredential);

  const inputText = [{ text: "This is a test." }];
  const translateResponse = await translationClient.path("/translate").post({
    body: inputText,
    queryParameters: {
      to: "fr",
      from: "en",
    },
  });

  const translations = translateResponse.body;
  for (const translation of translations) {
    console.log(
      `Text was translated to: '${translation?.translations[0]?.to}' and the result is: '${translation?.translations[0]?.text}'.`
    );
  }
}

main().catch((err) => {
    console.error("An error occurred:", err);
    process.exit(1);
  });

  module.exports = { main };

Ejecución de la aplicación

Una vez que agregue un código de ejemplo a la aplicación, ejecute el programa de la siguiente forma:

Vaya a la carpeta donde tenga la aplicación de traducción de texto (text-translation-app).
Escriba el siguiente comando en el terminal:
```
node index.js
```

Este es un fragmento de la salida esperada:

Captura de pantalla de la salida de JavaScript en la ventana del terminal.

Configuración del proyecto de Python

Asegúrese de que tiene la versión más reciente de Python 3.x. La instalación de Python incluye el paquete del instalador de Python (pip).

Sugerencia

Si es la primera vez que usa Python, pruebe el módulo de Learn Introducción a Python.
Abra una ventana de terminal e instale la biblioteca cliente Azure Text translation para Python con pip:
```
pip install azure-ai-translation-text==1.0.0b1
```

Compilación de la aplicación

Para interactuar con Translator mediante la biblioteca cliente, debe crear una instancia de la TextTranslationClientclase . Para ello, creará un TranslatorCredential con key desde Azure Portal y una instancia de TextTranslationClient. Para obtener más información, consulteSDK de texto de Translator.

Cree un archivo Python que se llame text-translation-app.py en el editor o IDE que prefiera usar.
Copie y pegue el siguiente ejemplo de código de traducción de texto en el archivo text-translation-app.py. Actualice <your-key>, <your-endpoint> y <region> con los valores de la instancia de Translator de Azure Portal.

Ejemplo de código

Importante

Traducir texto

Nota:

En este ejemplo, se usa un punto de conexión regional. Si usa el punto de conexión global, consulte Creación de un cliente de traducción de texto.

from azure.ai.translation.text import TextTranslationClient, TranslatorCredential
from azure.ai.translation.text.models import InputTextItem
from azure.core.exceptions import HttpResponseError

# set `<your-key>`, `<your-endpoint>`, and  `<region>` variables with the values from the Azure portal
key = "<your-key>"
endpoint = "<your-endpoint>"
region = "<region>"

credential = TranslatorCredential(key, region)
text_translator = TextTranslationClient(endpoint=endpoint, credential=credential)

try:
    source_language = "en"
    target_languages = ["es", "it"]
    input_text_elements = [ InputTextItem(text = "This is a test") ]

    response = text_translator.translate(content = input_text_elements, to = target_languages, from_parameter = source_language)
    translation = response[0] if response else None

    if translation:
        for translated_text in translation.translations:
            print(f"Text was translated to: '{translated_text.to}' and the result is: '{translated_text.text}'.")

except HttpResponseError as exception:
    print(f"Error Code: {exception.error.code}")
    print(f"Message: {exception.error.message}")

Ejecutar la aplicación

Una vez que agregue el ejemplo de código a la aplicación, compile y ejecute el programa:

Vaya a la carpeta donde tenga el archivo text-translation-app.py.

Escriba el siguiente comando en el terminal:

python text-translation-app.py

Este es un fragmento de la salida esperada:

Captura de pantalla de la salida de JavaScript en la ventana del terminal.

Eso es todo, ¡enhorabuena! En este inicio rápido, ha usado un SDK de traducción de texto para traducir texto.

Pasos siguientes

Obtenga más información sobre las opciones de desarrollo de traducción de texto:

Descripción general del SDK de traducción de texto

Referencia de traducción de texto V3

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-11-18

Compartir a través de

Inicio rápido: SDK de Azure Translator (traducción de texto)

Prerrequisitos

Configuración de un entorno de C#/.NET

Instalación de la biblioteca cliente con NuGet

Compilación de la aplicación

Ejemplo de código

Ejecución de la aplicación

Configuración del entorno Java

Creación de un proyecto de Gradle

Creación de una aplicación Java

Ejemplo de código

Compilación y ejecución de la aplicación**

Configuración del entorno de Node.js

Instalación de la biblioteca cliente

Compilación de la aplicación

Ejemplo de código

Ejecución de la aplicación

Configuración del proyecto de Python

Compilación de la aplicación

Ejemplo de código

Ejecutar la aplicación

Pasos siguientes

Comentarios

Recursos adicionales