Partilhar via

SDKs de tradução de documentos

  • Artigo

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

Idiomas suportados

O SDK de Tradução de Documentos suporta as seguintes linguagens de programação:

Versão do SDK do → de idioma Pacote Biblioteca de cliente Versão da API suportada
🆕 .NET/C# → 2.0.0-beta.1 NuGet Azure SDK for .NET (Azure SDK para .NET) Tradução de Documentos api-version=2024-05-01
🆕 Python → 1.1.0b1 PyPi Azure SDK for Python (Azure SDK para Python) Tradução de Documentos api-version=2024-05-01

Changelog e histórico de lançamentos

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

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

O SDK de Tradução de Documentos permite o uso e o gerenciamento do serviço de Tradução em seu aplicativo. O SDK se baseia nas APIs REST de tradução de documentos subjacentes para uso dentro do paradigma da linguagem de programação. Escolha a sua linguagem de programação preferida:

1. Instale a biblioteca de cliente 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. Importe a biblioteca de cliente SDK para seu aplicativo

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

3. Autenticar o cliente

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

Tradução em lote assíncrona

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 síncrona de um único documento

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 a sua aplicação

Tradução em lote assíncrona

As interfaces em lote de tradução de documentos requerem 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 onde os documentos traduzidos possam ser gravados (targetUri).
  3. Inclua o código do 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 síncrona de um único documento

Tradução de documento único

Opções de ajuda

Os Microsoft Q&A fóruns 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.

Gorjeta

Para se certificar de que vemos a sua pergunta de Perguntas e Respostas da Microsoft, marque-a com microsoft-translator. Para ter certeza de que vemos sua pergunta de estouro de pilha, marque-a com Azure AI Translator.

Próximos passos

Guia de início rápido do SDK de Tradução de Documentos Referência da API REST v1.1