Traduzione sincrona dei documenti
Funzionalità di riferimento
: Azure AI Traduttore → versione dell'API Traduzione
documenti: metodo HTTP 2024-05-01
: POST
- Utilizzare il
translate documentmetodo per tradurre in modo sincrono un singolo documento. - Il metodo non richiede un account di archiviazione BLOB di Azure.
- La risposta finale contiene il documento tradotto e viene restituita direttamente al client chiamante.
Importante
Tutte le richieste API alla funzionalità Traduzione documenti richiedono un endpoint di dominio personalizzato che si trova nella pagina di panoramica delle risorse nella portale di Azure.
Richiesta URL
curl -i -X POST "{your-document-translation-endpoint}/translator/document:translate?sourceLanguage=en&targetLanguage=hi&api-version={date}" -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}"
Intestazioni delle richieste
Per chiamare la funzionalità di traduzione sincrona tramite l'API REST, includere le intestazioni seguenti con ogni richiesta.
| Intestazione | Valore | Condizione |
|---|---|---|
| Ocp-Apim-Subscription-Key | La chiave del servizio Traduttore dal portale di Azure. | • Obbligatorio |
Parametri della richiesta
Parametri della stringa di query:
Parametri obbligatori
| Query parameter (Parametro di query) | Descrizione |
|---|---|
| api-version | Parametro obbligatorio. Versione dell'API richiesta dal client. Il valore corrente è 2023-11-01-preview. |
| targetLanguage | Parametro obbligatorio. Specifica la lingua del documento di output. La lingua di destinazione deve essere una delle lingue supportate incluse nell'ambito della traduzione. |
| • document= • type= |
Parametri obbligatori. • Percorso del percorso del file per il documento di origine e il tipo di formato di file. • Es: "document=@C:\Test\Test-file.txt;type=text/html |
| --output | Parametro obbligatorio. • Percorso per la posizione del file di destinazione. Il file tradotto viene stampato nel file di output.• Es: "C:\Test\Test-file-output.txt". L'estensione del file deve corrispondere a quella del file di origine. |
Parametri facoltativi
| Query parameter (Parametro di query) | Descrizione |
|---|---|
| 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. |
| • glossary= • type= |
• Percorso della posizione del file per il glossario personalizzato e il tipo di formato di file. • Es:"glossary=@D:\Test\SDT\test-simple-glossary.csv;type=text/csv |
| allowFallback | • Un booleano che specifica che il servizio può eseguire il fallback in un sistema generalnn quando non esiste un sistema personalizzato. I valori possibili sono: true (impostazione predefinita) o false. • allowFallback=false specifica che la traduzione deve usare solo sistemi sottoposti a training per la categoria specificata dalla richiesta.• Se non viene trovato alcun sistema con la specifica categoria, la richiesta restituirà un codice di stato 400. • allowFallback=true specifica che il servizio può eseguire il fallback in un sistema generalnn quando non esiste un sistema personalizzato. |
Corpo della richiesta
| Nome | Descrizione | Tipo di contenuto | Condizione |
|---|---|---|---|
| document | Documento di origine da tradurre. | Qualsiasi formato di documento supportato. | Obbligatorio |
| glossary | Documento contenente un elenco di termini con definizioni da usare durante il processo di traduzione. | Qualsiasi formato di glossario supportato. | Facoltativo |