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 da versão herdada.
A partir desta versão atual, o
get supported storage sourcesmétodo não é mais suportado. O serviço Tradutor só dá suporte ao Armazenamento de Blobs do Azure.
| Solicitar | Método | Descrição | Caminho da API |
|---|---|---|---|
| Single | Síncrono | Documento | Tradução |
| Traduzir documento | 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 a tradução | POSTAR | Inicie um trabalho de tradução de documentos em lote. | {document-translation-endpoint}/translator/document/batches?api-version={date} |
| Obter status de 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 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 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 documento 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 documentos 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 |
| Traduzir documento | 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 a 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 de 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 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 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 documento 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 documentos 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 suportadas. Atualmente, o serviço Tradutor só dá suporte ao Armazenamento de Blobs do Azure. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/storagesources |