Container: Traduzir documentos
Traduzir documento com o idioma de origem especificado.
URL de solicitação (usando cURL)
POST Pedido:
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íncronos
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 | Description | Condição |
|---|---|---|
-X quer --request POST |
O sinalizador -X especifica o método de solicitação para acessar a API. | Obrigatório |
{endpoint} |
O 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 suportados incluídos no escopo da tradução. | Obrigatório |
sourceLanguage |
Especifica o idioma do documento de entrada. Se o parâmetro não for especificado, a sourceLanguage deteção automática de idioma será aplicada para determinar o idioma de origem. |
Opcional |
-H quer --header "Ocp-Apim-Subscription-Key:{KEY} |
Cabeçalho de solicitação que especifica a chave de recurso de Tradução de Documentos que autoriza o acesso à API. | Obrigatório |
-F ou --form |
O caminho do arquivo para o documento que você deseja incluir com sua solicitação. Só é permitido um documento de origem. | Obrigatório |
• document=• type={contentType}/fileExtension |
• Caminho para o local do arquivo para o documento de origem. • Tipo de conteúdo e extensão de arquivo. Ex: "document=@C:\Test\test-file.md; type=texto/markdown" |
Obrigatório |
-o ou --output |
O caminho do arquivo para os resultados da resposta. | Obrigatório |
-F ou --form |
O caminho do arquivo para um glossário opcional a ser incluído com sua solicitação. O glossário requer uma bandeira separada --form . |
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: "glossário=@C:\Test\glossary-file.txt; type=texto/simples |
Opcional |
✔️ Para obter mais informações sobre contentTypeo , consulte Formatos de documento suportados.
Exemplo de código: tradução de documentos
Nota
- Cada exemplo é executado no
localhostque você especificou com odocker compose upcomando. - Enquanto o contêiner está em execução,
localhostaponte para o próprio contêiner. - Você não precisa usar
localhost:5000o . Você pode usar qualquer porta que ainda não esteja em uso em seu ambiente host.
Documento de exemplo
Para este projeto, você precisa de um documento de origem para traduzir. Você pode baixar nosso documento de exemplo de tradução de documentos e armazená-lo na mesma pasta que seu compose.yaml arquivo (container-environment). O nome do ficheiro é document-translation-sample.docx e a língua de partida é o 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 é devolvido com a resposta.
- O método POST bem-sucedido retorna um código de
200 OKresposta indicando que o serviço criou a solicitação.