Compartilhar via

SDKs de Tradução de Documento

  • Artigo

A Tradução de Documento é um recurso da API REST baseado em nuvem do serviço de Tradutor de IA do Azure. A API de Tradução de Documento permite traduções rápidas e precisas de documentos inteiros, de forma assíncrona, em idiomas com suporte e em vários formatos de arquivo. O SDK (kit de desenvolvimento de software) de Tradução de Documento é um conjunto de bibliotecas e ferramentas que permite integrar facilmente os recursos da API REST de Tradução de Texto em seus aplicativos.

Idiomas com suporte

O SDK de Tradução de Documento dá suporte às seguintes linguagens de programação:

Idioma → versão do SDK Pacote Biblioteca do cliente Versão da API compatível
🆕 .NET/C# → 2.0.0-beta.1 NuGet SDK do Azure para .NET Tradução de documentos api-version=2024-05-01
🆕 Python → 1.1.0b1 PyPi SDK do Azure para Python Tradução de documentos api-version=2024-05-01

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 Documento.

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

O SDK de Tradução de Documento permite o uso e o gerenciamento do serviço de Tradução de Documento em seu aplicativo. O SDK baseia-se na API REST de Tradução de Documento subjacente para uso dessas APIs dentro do paradigma da linguagem de programação. Escolha sua linguagem de programação preferida:

1. Instalar a biblioteca de clientes do SDK

dotnet add package Azure.AI.Translation.Document --version 2.0.0-beta.1

Install-Package Azure.AI.Translation.Document -Version 2.0.0-beta.1

2. Importar a biblioteca de clientes do SDK para seu aplicativo

using System;
using Azure.Core;
using Azure.AI.Translation.Document;

3. Autenticar o cliente

Crie uma instância do objeto DocumentTranslationClient para interagir com o SDK de Tradução de Documento e, em seguida, chame métodos nesse objeto de cliente para interagir com o serviço. O DocumentTranslationClient é a interface principal para usar a biblioteca de clientes de Tradução de Documento. Ele fornece métodos síncronos e assíncronos para executar operações.

Tradução assíncrona em lote

private static readonly string endpoint = "<your-custom-endpoint>";
private static readonly string key = "<your-key>";

DocumentTranslationClient client = new DocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(key));

Tradução de documento único síncrona

private static readonly string endpoint = "<your-custom-endpoint>";
private static readonly string key = "<your-key>";

SingleDocumentTranslationClient client = new SingleDocumentTranslationClient(new Uri(endpoint), new AzureKeyCredential(apiKey));

4. Crie seu aplicativo

Tradução assíncrona em lote

As interfaces do lote de tradução de documento exigem a seguinte entrada:

  1. Carregue seus arquivos em um contêiner de origem do Armazenamento de Blobs do Azure (sourceUri).
  2. Forneça um contêiner de destino em que os documentos traduzidos podem ser gravados (targetUri).
  3. Inclua o código de idioma de destino (targetLanguage).

Uri sourceUri = new Uri("<your-source container-url");
Uri targetUri = new Uri("<your-target-container-url>");
string targetLanguage = "<target-language-code>";

DocumentTranslationInput input = new DocumentTranslationInput(sourceUri, targetUri, targetLanguage)

Tradução de documento único síncrona

Tradução de documento único

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 monitora os fóruns e responde a perguntas que a comunidade ainda não respondeu.

Dica

Para ter certeza de que veremos a sua pergunta na Q&A da Microsoft, marque-a com microsoft-translator. Para ter certeza de que veremos sua pergunta no Stack Overflow, marque-a com Azure AI Translator.

Próximas etapas

Início rápido do SDK da Tradução de DocumentoReferência de API REST da Tradução de Documento v1.1