SDK de Azure Text Translation (versión preliminar)

Artículo
08/24/2023

Importante

Los SDK de texto de Translator están disponibles actualmente en versión preliminar pública. Antes de la disponibilidad general (GA), las características, los enfoques y los procesos podrían cambiar en función de los comentarios de los usuarios.

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-beta.1	NuGet	SDK de Azure para .NET	Translator v3.0
Java✱ → 1.0.0-beta.1	Repositorio MVN	SDK de Azure para Java	Translator v3.0
JavaScript → 1.0.0-beta.1	npm	Azure SDK para JavaScript	Translator v3.0
Python → 1.0.0b1	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 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 TextTranslationClient
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:

Screenshot of the keys and endpoint location in the 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 Azure Text Translation 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

Share via