SDK de traducción de texto de Azure

Artículo
09/29/2024

La traducción de texto de Azure es una característica de la API de REST basada en la nube del servicio Traductor de Azure. La API de Text Translation permite realizar traducciones de texto de origen a destino rápidas y precisas en tiempo real. El kit de desarrollo de software (SDK) de Text Translation es un conjunto de bibliotecas y herramientas que le permiten integrar fácilmente las funcionalidades de la API de REST de Text Translation en sus aplicaciones. El SDK de Text Translation está disponible en plataformas de programación C#/.NET, Java, JavaScript y Python.

Idiomas admitidos

El SDK de la traducción de texto admite los lenguajes de programación y las plataformas:

Lenguaje → Versión del SDK	Paquete	Biblioteca de cliente	Versión de API compatible
.NET/C# → 1.0.0	NuGet	SDK de Azure para .NET	Translator v3.0
Java✱ → 1.0.0	Repositorio de Maven	SDK de Azure para Java	Translator v3.0
JavaScript → 1.0.0	npm	Azure SDK para JavaScript	Translator v3.0
Python → 1.0.1	PyPi	SDK de Azure para Python	Translator v3.0

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

Registro de cambios e historial de versiones

En esta sección se ofrece una descripción basada en versiones de las características, funcionalidades, cambios, actualizaciones y mejoras de Text Translation.

Versión de disponibilidad general del SDK de Translator Text de mayo de 2024

En esta versión se incluyen las siguientes actualizaciones:

Versión preliminar del SDK de Text Translator de abril de 2023

En esta versión se incluyen las siguientes actualizaciones:

Uso del SDK de Text Translation en las aplicaciones

El SDK de Text Translation habilita el uso y la administración del servicio de Text Translation en la aplicación. El SDK se basa en la API de REST de Text Translation subyacente, lo que le permite usar fácilmente esas API dentro del paradigma del lenguaje de programación. A continuación, le explicamos cómo utilizar el SDK de Text Translation para su lenguaje de programación preferido:

1. Instale la biblioteca cliente de SDK

dotnet add package Azure.AI.Translation.Text --version 1.0.0-beta.1

Install-Package Azure.AI.Translation.Text -Version 1.0.0-beta.1

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-ai-translation-text</artifactId>
    <version>1.0.0-beta.1</version>
</dependency>

implementation("com.azure:azure-ai-translation-text:1.0.0-beta.1")

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

pip install azure-ai-translation-text==1.0.0b1

2. Importe la biblioteca cliente del SDK en la aplicación

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

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;

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

from azure.core.credentials import AzureKeyCredential
from azure.ai.translation.text import TextTranslationClient

3. Autenticar el cliente

La interacción con el servicio Translator mediante la biblioteca cliente comienza con la creación de una instancia de la TextTranslationClientclase. Necesita la clave de API y la región para crear instancias de un objeto de cliente. La clave de API de Text Translation se encuentra en Azure Portal:

Captura de pantalla de ubicación de las claves y el punto de conexión en Azure Portal.

Con el punto de conexión global (predeterminado)

string key = "<your-key>";

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

Con un punto de conexión regional


Uri endpoint = new("<your-endpoint>");
string key = "<your-key>";
string region = "<region>";

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

Con el punto de conexión global (predeterminado)


String apiKey = "<your-key>";
AzureKeyCredential credential = new AzureKeyCredential(apiKey);

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

Con un punto de conexión regional

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

AzureKeyCredential credential = new AzureKeyCredential(apiKey);

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


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

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


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

key = "<your-key>"
endpoint = "<your-endpoint>"
region = "<region>"


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

4. Compilación de la aplicación

Crea un objeto de cliente para interactuar con el SDK de Text Translation y, a continuación, llama métodos en ese objeto de cliente para interactuar con el servicio. Los SDK proporcionan métodos sincrónicos y asincrónicos. Para obtener más información, consulte el repositorio de ejemplo de Text Translation para .NET/C#.

Opciones de ayuda

Los foros de Microsoft Q&A y Stack Overflow están disponibles para que la comunidad de desarrolladores haga preguntas sobre Traducción de texto de Azure y otros servicios y las responda. Microsoft supervisa los foros y responde a preguntas que la comunidad aún no ha respondido. Para asegurarse de que veamos su pregunta, etiquétela con azure-text-translation.

Pasos siguientes

Inicio rápido de Text Translation

Guía de referencia de Text Translation v3.0

Compartir a través de