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
get supported storage sourcesmétodo não é mais suportado. 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 |