Guia da API REST de tradução síncrona
Referência
Serviço: Tradução de documentos da IA do Azure
Versão da API: v1.1
Traduzir de forma síncrona um único documento.
URL de solicitação
POST:
curl -i -X POST "{your-document-translation-endpoint}/translator/document:translate?sourceLanguage=en&targetLanguage=hi&api-version=2023-11-01-preview" -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, você precisa incluir 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 é 2023-11-01-preview. |
| 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. |
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 |