Contenitore: Traduci documenti

  • Articolo

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 localhost specificato con il docker compose up comando .
  • Mentre il contenitore è in esecuzione, localhost punta 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 OK che indica che il servizio ha creato la richiesta.

Passaggi successivi

Altre informazioni sulla traduzione sincrona dei documenti