SDK de Tradução de Texto do Azure (visualização)

Artigo
01/10/2024

Importante

Os SDKs de texto do Translator estão atualmente disponíveis em visualização pública. Recursos, abordagens e processos podem mudar, antes da Disponibilidade Geral (GA), com base no feedback do usuário.

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 kit de desenvolvimento de software (SDK) 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

O SDK de Tradução de Texto suporta as linguagens e plataformas de programação:

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

Changelog 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 das liberações, alterações, atualizações e aprimoramentos de recursos.

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

Esta 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 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 TextTranslationClient
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:

Screenshot of the keys and endpoint location in the Azure portal.

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 cliente para interagir com o SDK de tradução de texto e, em seguida, chame métodos nesse objeto 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 de Perguntas e Respostas da Microsoft e Estouro de Pilha 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 da Tradução de Texto v3.0

Partilhar via