Operações de tradução de documentos

Recurso de referência
: Azure AI Translator → tradução de documentos

A Tradução de Documentos é um recurso baseado em nuvem do serviço Azure AI Translator e faz parte da família de APIs REST do serviço Azure AI. 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 de dados. Os métodos disponíveis estão listados nas tabelas a seguir:

Versão da API: 2024-05-01

Nota

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

• A partir desta versão atual, o método é suportado get supported storage sources por mais tempo. O serviço Translator suporta apenas o armazenamento de Blob do Azure.

Pedir	Método	Description	Caminho da API
Solteiro	Síncrono	Documento	Tradução
Definição da palavra document	POST	Traduza um único documento de forma síncrona.	{document-translation-endpoint}/translator/document:translate?targetLanguage={target_language}&api-version={date}
Batch	Assíncrono	Documentação	Tradução
Iniciar tradução	POST	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 o status de 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 o status de um documento específico	GET	Solicite 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 atualmente em processamento ou em fila.	{document-translation-endpoint}/translator/document/batches/{id}?api-version={date}
Obtenha formatos de documentos suportados	GET	Solicite uma lista de formatos de documentos suportados.	{document-translation-endpoint}/translator/document/formats?api-version={date}&type=document
Obtenha formatos de glossário suportados	GET	Solicite uma lista dos formatos de glossário suportados.	{document-translation-endpoint}/translator/document/formats?api-version={date}&type=glossary

Legado

Nota

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

Pedir	Método	Description	Caminho da API
Solteiro	Síncrono	Documento	Tradução
Definição da palavra document	POST	Traduza um único documento de forma síncrona.	{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íncrono	Documentação	Tradução
Iniciar tradução	POST	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 o status de todos os documentos	GET	Solicite 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 o status de um documento específico	GET	Solicite 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 atualmente em processamento ou em fila.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}
Obtenha formatos de documentos suportados	GET	Solicite uma lista de formatos de documentos suportados.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/documents/formats
Obtenha formatos de glossário suportados	GET	Solicite uma lista dos formatos de glossário suportados.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/glossaries/formats
Obtenha fontes de armazenamento suportadas	GET	Solicite uma lista de fontes/opções de armazenamento suportadas. Atualmente, o serviço Translator suporta apenas o armazenamento de Blob do Azure.	{document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/storagesources

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