Operações de tradução de documentos

Recurso de referência
: Tradutor de IA do Azure → tradução de documentos

A tradução de documentos é um recurso baseado em nuvem do serviço Tradutor de IA do Azure e faz parte da família de APIs REST do serviço de IA do Azure. A API de Tradução de Documentos em Lote traduz documentos em todos os idiomas e dialetos suportados, preservando a estrutura do documento e o formato dos dados. Os métodos disponíveis estão listados nas tabelas a seguir:

Versão da API: 2024-05-01

Observação

• A versão atual é compatível com versões anteriores com a versão herdada.

• A partir desta versão atual, o método é suportado get supported storage sources por mais tempo. O serviço Tradutor oferece suporte apenas ao armazenamento de Blobs do Azure.

Solicitar	Método	Descrição	Caminho da API
Single	Síncrono	Documento	Tradução
Definição da palavra document	POSTAR	Traduzir de forma síncrona um único documento.	{document-translation-endpoint}/translator/document:translate?targetLanguage={target_language}&api-version={date}
Batch	Assíncronos	Documentos	Tradução
Iniciar tradução	POSTAR	Inicie um trabalho de tradução de documentos em lote.	{document-translation-endpoint}/translator/document/batches?api-version={date}
Obter status para todos os trabalhos de tradução	GET	Solicite uma lista e o status dos trabalhos de tradução enviados pelo usuário.	{document-translation-endpoint}/translator/document/batches?api-version={date}
Obter status para um trabalho de tradução específico	GET	Solicite um resumo do status de um trabalho de tradução específico. A resposta inclui o status geral do trabalho e o status dos documentos que estão sendo traduzidos como parte desse trabalho.	{document-translation-endpoint}/translator/document/batches/{id}?api-version={date}
Obter status para todos os documentos	GET	Solicite o status de todos os documentos em um trabalho de tradução.	{document-translation-endpoint}/translator/document/batches/{id}/documents?api-version={date}
Obter status para um documento específico	GET	Solicitar o status de um documento específico em um trabalho.	{document-translation-endpoint}/translator/document/batches/{id}/documents/{documentId}?api-version={date}
Cancelar tradução	DELETE	Cancele um trabalho de tradução de documentos que esteja sendo processado ou enfileirado no momento.	{document-translation-endpoint}/translator/document/batches/{id}?api-version={date}
Obter formatos de documento compatíveis	GET	Solicite uma lista de formatos de documento suportados.	{document-translation-endpoint}/translator/document/formats?api-version={date}&type=document
Obter formatos de glossário compatíveis	GET	Solicite uma lista de formatos de glossário suportados.	{document-translation-endpoint}/translator/document/formats?api-version={date}&type=glossary

Herdada

Observação

• A versão herdada é compatível com a versão atual. Você pode usar as operações de qualquer versão para traduzir documentos.
• Recomendamos migrar seus aplicativos para a versão mais recente para se beneficiar de uma experiência aprimorada e recursos avançados.

Solicitar	Método	Descrição	Caminho da API
Single	Síncrono	Documento	Tradução
Definição da palavra document	POSTAR	Traduzir de forma síncrona um único documento.	{document-translation-endpoint}/translator/document:translate?sourceLanguage={source language}&targetLanguage={target language}&api-version=2024-05-01" -H "Ocp-Apim-Subscription-Key:{your-key}" -F "document={path-to-your-document-with-file-extension};type={ContentType}/{file-extension}" -F "glossary={path-to-your-glossary-with-file-extension};type={ContentType}/{file-extension}" -o "{path-to-output-file}"
Batch	Assíncronos	Documentos	Tradução
Iniciar tradução	POSTAR	Inicie um trabalho de tradução de documentos em lote.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches
Obter status para todos os trabalhos de tradução	GET	Solicite uma lista e o status dos trabalhos de tradução enviados pelo usuário.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches
Obter status para um trabalho de tradução específico	GET	Solicite um resumo do status de um trabalho de tradução específico. A resposta inclui o status geral do trabalho e o status dos documentos que estão sendo traduzidos como parte desse trabalho.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}
Obter status para todos os documentos	GET	Solicitar o status de um documento específico em um trabalho.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents
Obter status para um documento específico	GET	Solicitar o status de um documento específico em um trabalho.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents/{documentId}
Cancelar tradução	DELETE	Cancele um trabalho de tradução de documentos que esteja sendo processado ou enfileirado no momento.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}
Obter formatos de documento compatíveis	GET	Solicite uma lista de formatos de documento suportados.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/documents/formats
Obter formatos de glossário compatíveis	GET	Solicite uma lista de formatos de glossário suportados.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/glossaries/formats
Obter fontes de armazenamento compatíveis	GET	Solicite uma lista de fontes/opções de armazenamento compatíveis. Atualmente, o serviço Tradutor oferece suporte apenas ao armazenamento de Blobs do Azure.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/storagesources

Explore nossas bibliotecas de cliente e SDKs para linguagens de programação C# e Python..