Contenitore: Traduci documenti
Tradurre il documento con la lingua di origine specificata.
URL della richiesta (con cURL)
POST richiesta:
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}"
Esempio:
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"
Intestazioni e parametri delle richieste sincrone
Usare l'elaborazione sincrona della traduzione per inviare un documento come parte del corpo della richiesta HTTP e ricevere il documento tradotto nella risposta HTTP.
| Query parameter (Parametro di query) | Descrizione | Condizione |
|---|---|---|
-X o --request POST |
Il flag -X specifica il metodo di richiesta per accedere all'API. | Obbligatorio |
{endpoint} |
URL per l'endpoint della risorsa Traduzione documenti | Obbligatorio |
targetLanguage |
Specifica la lingua del documento di output. La lingua di destinazione deve essere una delle lingue supportate incluse nell'ambito della traduzione. | Obbligatorio |
sourceLanguage |
Specifica la lingua del documento di input. Se non si specifica il parametro sourceLanguage, viene applicato il rilevamento automatico della lingua per determinare la lingua di origine. |
Facoltativo |
-H o --header "Ocp-Apim-Subscription-Key:{KEY} |
Intestazione della richiesta che specifica la chiave della risorsa Traduzione documenti che autorizza l'accesso all'API. | Obbligatorio |
-F oppure --form |
Percorso file del documento da includere con la richiesta. È consentito un solo documento di origine. | Obbligatorio |
• document=• type={contentType}/fileExtension |
• Percorso della posizione del file per il documento di origine. • Tipo di contenuto ed estensione di file. Ad esempio: "document=@C:\Test\test-file.md; type=text/markdown" |
Obbligatorio |
-o oppure --output |
Percorso file per i risultati della risposta. | Obbligatorio |
-F oppure --form |
Percorso file di un glossario facoltativo da includere con la richiesta. Il glossario richiede un flag --form separato. |
Facoltativo |
• glossary=• type={contentType}/fileExtension |
• Percorso della posizione del file per il file di glossario facoltativo. • Tipo di contenuto ed estensione di file. Ex: "glossary=@C:\Test\glossary-file.txt;type=text/plain |
Facoltativo |
✔️ Per altre informazioni su contentType, vedere Formati di documento supportati.
Esempio di codice: traduzione di documenti
Nota
- Ogni esempio viene eseguito nell'oggetto
localhostspecificato con ildocker compose upcomando . - Mentre il contenitore è in esecuzione,
localhostpunta al contenitore stesso. - Non è necessario usare
localhost:5000. È possibile usare qualsiasi porta non già in uso nell'ambiente host.
Documento di esempio
Per questo progetto è necessario un documento di origine da tradurre. È possibile scaricare il documento di esempio di traduzione dei documenti per e archiviarlo nella stessa cartella del compose.yaml file (container-environment). Il nome del file è document-translation-sample.docx e la lingua di origine è inglese.
Eseguire query sull'endpoint di Azure AI Translator (documento)
Ecco un esempio di richiesta HTTP cURL con 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"
Al termine dell'operazione:
- Il documento tradotto viene restituito con la risposta.
- La corretta esecuzione del metodo POST restituisce un codice di risposta
200 OKche indica che il servizio ha creato la richiesta.