Contêiner: Traduzir documentos
Traduza o documento com o idioma de origem especificado.
URL de solicitação (usando cURL)
POST pedir:
POST "http://localhost:{port}/translator/document:translate?sourceLanguage={sourceLanguage}&targetLanguage={targetLanguage}&api-version={api-version}" -F "document=@{path-to-your-document-with-file-extension};type={ContentType}/{file-extension}" -o "{path-to-output-file-with-file-extension}"
Exemplo:
curl -i -X POST "http://localhost:5000/translator/document:translate?sourceLanguage=en&targetLanguage=hi&api-version=2024-05-01" -F "document=@C:\Test\test-file.md;type=text/markdown" -o "C:\translation\translated-file.md"
Cabeçalhos e parâmetros de solicitação síncrona
Use o processamento de tradução síncrona para enviar um documento como parte do corpo da solicitação HTTP e receber o documento traduzido na resposta HTTP.
| Parâmetro de consulta | Descrição | Condição |
|---|---|---|
-X ou --request POST |
O sinalizador -X especifica o método de solicitação para acessar a API. | Obrigatório |
{endpoint} |
A URL do ponto de extremidade do recurso de tradução de documentos | Obrigatório |
targetLanguage |
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. | Obrigatório |
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. |
Opcional |
-H ou --header "Ocp-Apim-Subscription-Key:{KEY} |
Cabeçalho de solicitação que especifica a chave do recurso de tradução de documento que autoriza o acesso à API. | Obrigatório |
-F ou --form |
O caminho de arquivo para o documento que você deseja incluir com sua solicitação. Apenas um documento de origem é permitido. | Obrigatório |
• document=• type={contentType}/fileExtension |
• Caminho para o local do arquivo para seu documento de origem. • Tipo de conteúdo e extensão de arquivo. Ex: "document=@C:\Test\test-file.md; type=text/markdown" |
Obrigatório |
-o ou --output |
O caminho de arquivo para os resultados da resposta. | Obrigatório |
-F ou --form |
O caminho de arquivo para um glossário opcional a ser incluído com sua solicitação. O glossário requer um sinalizador --form separado. |
Opcional |
• glossary=• type={contentType}/fileExtension |
• Caminho para o local do arquivo para seu arquivo de glossário opcional. • Tipo de conteúdo e extensão de arquivo. Ex: "glossary=@C:\Test\glossary-file.txt;type=text/plain |
Opcional |
✔️ Para obter mais informações sobre contentType, consulte Formatos de documento com suporte.
Exemplo de código: tradução de documentos
Observação
- Cada exemplo é executado no
localhostque você especificou com odocker compose upcomando. - Enquanto o contêiner está em execução,
localhostaponta para o próprio contêiner. - Você não precisa usar
localhost:5000. Você pode usar qualquer porta que ainda não esteja em uso em seu ambiente host.
Exemplo de documento
Para este projeto, você precisa de um documento de origem para traduzir. Você pode baixar nosso documento de amostra de tradução de documentos e armazená-lo na mesma pasta que seu compose.yaml arquivo (container-environment). O nome do arquivo é document-translation-sample.docx e o idioma de origem é inglês.
Consultar o ponto de extremidade do Azure AI Translator (documento)
Aqui está um exemplo de solicitação HTTP cURL usando localhost:5000:
curl -v "http://localhost:5000/translator/document:translate?sourceLanguage=en&targetLanguage=es&api-version=2024-05-01" -F "document=@document-translation-sample-docx" -o "C:\translation\translated-file.md"
Após a conclusão bem-sucedida:
- O documento traduzido é retornado com a resposta.
- O método POST bem-sucedido retorna um código de resposta
200 OKindicando que o serviço criou a solicitação.