SDK de Tradução de Texto do Azure

Artigo
09/30/2024

A Tradução de Texto do Azure é um recurso da API REST baseado em nuvem do serviço Tradutor de IA do Azure. A API de Tradução de Texto permite traduções de texto de origem para destino rápidas e precisas em tempo real. O SDK (kit de desenvolvimento de software) de Tradução de Texto é um conjunto de bibliotecas e ferramentas que permite integrar facilmente os recursos da API REST de Tradução de Texto em seus aplicativos. O SDK de Tradução de Texto está disponível em plataformas de programação em C#/.NET, Java, JavaScript e Python.

Idiomas com suporte

O SDK de Tradução de Texto dá suporte às linguagens e plataformas de programação:

Idioma → versão do SDK	Pacote	Biblioteca do cliente	Versão da API compatível
.NET/C# → 1.0.0	NuGet	SDK do Azure para .NET	Tradutor v3.0
Java✱ → 1.0.0	Repositório da Maven	SDK do Azure para Java	Tradutor v3.0
JavaScript → 1.0.0	npm	SDK do Azure para JavaScript	Tradutor v3.0
Python → 1.0.1	PyPi	SDK do Azure para Python	Tradutor v3.0

✱ O SDK de Tradução de Texto do Azure para Java foi testado no Windows, Linux e macOS e tem suporte nessas plataformas. O SDK não foi testado em outras plataformas e não é compatível com implantações do Android.

Log de alterações e histórico de versões

Esta seção fornece uma descrição baseada em versão dos lançamentos, alterações, atualizações e aprimoramentos de recursos e funcionalidades da Tradução de Texto.

Versão GA do SDK de Tradução de Texto de Maio de 2024

Essa versão inclui as seguintes atualizações:

Versão prévia do SDK de Tradução de Texto de abril de 2023

Essa versão inclui as seguintes atualizações:

Usar o SDK de Tradução de Texto em seus aplicativos

O SDK de Tradução de Texto permite o uso e o gerenciamento do serviço de Tradução de Texto em seu aplicativo. O SDK baseia-se na API REST de Tradução de Texto subjacente, permitindo que você use facilmente essas APIs dentro do paradigma da linguagem de programação. Veja como usar o SDK de Tradução de Texto para sua linguagem de programação preferida:

1. Instalar a biblioteca de clientes do 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. Importar a biblioteca de clientes do SDK para seu aplicativo

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 o cliente

A interação com o serviço Tradutor usando a biblioteca de clientes começa com a criação de uma instância da classe TextTranslationClient. Você precisa da chave de API e da região para instanciar um objeto cliente. A chave da API de Tradução de Texto é encontrada no portal do Azure:

Captura de tela da localização das chaves e do ponto de extremidade no portal do Azure.

Usando o ponto de extremidade global (padrão)

string key = "<your-key>";

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

Usando um ponto de extremidade regional


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

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

Usando o ponto de extremidade global (padrão)


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

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

Usando um ponto de extremidade 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. Crie seu aplicativo

Criar um objeto de cliente para interagir com o SDK de Tradução de Texto e, em seguida, chamar métodos nesse objeto de cliente para interagir com o serviço. Os SDKs fornecem métodos síncronos e assíncronos. Para obter mais informações, consulte o repositório de exemplo de Tradução de Texto para .NET/C#.

Opções de ajuda

Os fóruns Microsoft Q&A e Stack Overflow estão disponíveis para a comunidade de desenvolvedores fazer perguntas e responder dúvidas sobre a Tradução de Texto do Azure e outros serviços. A Microsoft monitora os fóruns e responde a perguntas que a comunidade ainda não respondeu. Para ter certeza de que veremos a sua pergunta, marque-a com azure-text-translation.

Próximas etapas

Guia de início rápido da Tradução de Texto

Guia de referência da Tradução de Texto v3.0

Compartilhar via