Tradução de documento síncrono
Referência
Recurso: Tradutor de IA do Azure → Tradução de Documento
Versão da API: 2024-05-01
Método HTTP: POST
- Use o método
translate documentpara traduzir de forma síncrona um único documento. - O método não requer uma conta de armazenamento de Blobs do Azure.
- A resposta final contém o documento traduzido e é retornada diretamente ao cliente que está fazendo a chamada.
Importante
Todas as solicitações de API para o recurso de Tradução de Documento exigem um ponto de extremidade de domínio personalizado localizado na página de visão geral do recurso no portal do Azure.
URL de solicitação
curl -i -X POST "{your-document-translation-endpoint}/translator/document:translate?sourceLanguage=en&targetLanguage=hi&api-version={date}" -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}"
Cabeçalhos da solicitação
Para chamar o recurso de tradução síncrona por meio da API REST, inclua os seguintes cabeçalhos em cada solicitação.
| Cabeçalho | Valor | Condição |
|---|---|---|
| Ocp-Apim-Subscription-Key | Sua chave de serviço de Tradução do portal do Azure. | • Obrigatório |
Parâmetros da solicitação
Parâmetros da cadeia de caracteres de consulta:
Parâmetros obrigatórios
| Parâmetro de consulta | Descrição |
|---|---|
| api-version | Parâmetro obrigatório. Versão da API solicitada pelo cliente. O valor atual é 2024-05-01. |
| targetLanguage | Parâmetro obrigatório. Especifica o idioma do documento de saída. O idioma de destino deve ser um dos idiomas com suporte incluídos no escopo da tradução. |
| - documento= • type= |
Parâmetros necessários. • Caminho para o local do arquivo para seu documento de origem e tipo de formato de arquivo. • Ex: "document=@C:\Test\Test-file.txt;type=text/html |
| --saída | Parâmetro obrigatório. • Caminho do arquivo para o local do arquivo de destino. Seu arquivo traduzido está impresso no arquivo de saída. • Ex: "C:\Test\Test-file-output.txt". A extensão do arquivo deve ser a mesma do arquivo de origem. |
Parâmetros opcionais
| Parâmetro de consulta | Descrição |
|---|---|
| sourceLanguage | Especifica o idioma do documento de entrada. Se o parâmetro sourceLanguage não for especificado, a detecção automática de idioma será aplicada para determinar o idioma de origem. |
| - glossário= • type= |
• Caminho para o local do arquivo do seu glossário personalizado e tipo de formato de arquivo. • Ex:"glossary=@D:\Test\SDT\test-simple-glossary.csv;type=text/csv |
| allowFallback | • Um booleano que especifica que o serviço tem permissão para retornar a um sistema generalnn quando não houver um sistema personalizado. Os valores possíveis são: true (padrão) ou false. - allowFallback=false especifica que a tradução deve usar somente sistemas treinados para a categoria especificada pela solicitação.- Se nenhum sistema for encontrado com a categoria específica, a solicitação retornará um código de status 400. • allowFallback=true especifica que o serviço tem permissão para retornar a um sistema generalnn quando não houver um sistema personalizado. |
| category | Uma cadeia de caracteres especificando a categoria (domínio) para a tradução. Esse parâmetro é usado para obter traduções de um sistema personalizado compilado com Tradutor Personalizado. Para usar seu sistema personalizado implantado para tradução de documento síncrona, adicione o Category ID dos detalhes do projeto do Tradutor Personalizado ao parâmetro category. O valor padrão será "generalnn". |
Corpo da solicitação
| Nome | Descrição | Tipo de conteúdo | Condição |
|---|---|---|---|
| documento | Documento de origem a ser traduzido. | Qualquer um dos formatos de documento com suporte. | Obrigatório |
| glossário | Documento que contém uma lista de termos com definições a serem usadas durante o processo de tradução. | Qualquer um dos formatos de glossário com suporte. | Opcional |