SDK de tradução de texto do Azure

2025-05-28

A tradução de Texto do Azure é um recurso de API REST baseado em nuvem do serviço Azure AI Translator. A API de tradução de texto permite traduções de texto rápidas e precisas da fonte para o destino em tempo real. O SDK (Software Development Kit) de tradução de texto é um conjunto de bibliotecas e ferramentas que permitem 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 suportados

SDK de tradução de texto suporta as linguagens de programação e plataformas:

Versão do SDK de idioma	Embalagem	Biblioteca de cliente	Versão da API suportada
.NET/C# → 1.0.0	NuGet	Azure SDK for .NET (Azure SDK para .NET)	Tradutor v3.0
Java✱ → 1.0.0	Repositório 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	Azure SDK for Python (Azure SDK para Python)	Tradutor v3.0

✱ O SDK de tradução de texto do Azure para Java é testado e suportado nas plataformas Windows, Linux e macOS. Ele não é testado em outras plataformas e não suporta implantações do Android.

Registro de alterações e histórico de lançamentos

Esta seção fornece uma descrição baseada em versão do recurso de tradução de texto e liberações, alterações, atualizações e aprimoramentos de recursos.

Versão de maio de 2024 (GA) do Translator Text SDK

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

Versão 1.0.0 (2024-05-21)
Alvos Tradução de texto v3.0
Lançamento da versão GA

Pacote (NuGet)

Registo de alterações/Histórico de versões

LEIA-ME

Amostras

Versão prévia do Translator Text SDK de abril de 2023

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

Versão 1.0.0-beta.1 (2023-04-17)
Alvos Tradução de texto v3.0
Lançamento da versão inicial

Pacote (NuGet)

Registo de alterações/Histórico de versões

LEIA-ME

Amostras

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 se baseia na API REST de tradução de texto subjacente, permitindo que você use facilmente essas APIs dentro do seu paradigma de linguagem de programação. Veja como você usa o SDK de tradução de texto para sua linguagem de programação preferida:

1. Instale a biblioteca de cliente 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 a biblioteca de cliente 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 Translator usando a biblioteca do cliente começa com a criação de uma instância da TextTranslationClientclasse. Você precisa de sua chave de API e região para instanciar um objeto cliente. A chave da API de tradução de texto encontra-se no portal do Azure:

Captura de ecrã das chaves e da localização 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 a sua aplicação

Crie um objeto de cliente para interagir com o SDK de tradução de texto e, em seguida, chame 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 e responder perguntas sobre a tradução de texto do Azure e outros serviços. A Microsoft monitoriza os fóruns e responde a perguntas que a comunidade ainda não respondeu. Para se certificar de que vemos a sua pergunta, marque-a com azure-text-translation.

Próximos passos

Guia de início rápido da tradução de texto

Guia de referência de tradução de texto v3.0