Cloud Translation - Advanced supporta la traduzione di testo utilizzando modelli di traduzione AutoML personalizzati e per la creazione di glossari per garantire che l'API Cloud Translation traduca correttamente la terminologia specifica del dominio di un cliente.
Se vuoi utilizzare modelli personalizzati AutoML per il tuo progetto, devi abilitare l'API AutoML (automl.googleapis.com). Per istruzioni sull'installazione dell'interfaccia a riga di comando di Google Cloud, sulla configurazione di un progetto con un account di servizio e su come ottenere un token di accesso, consulta la pagina Configurazione. Se prevedi di utilizzare un glossario o le funzionalità batch, devi anche creare un bucket Cloud Storage e concedere al tuo account di servizio l'accesso.
Per tradurre documenti formattati, ad esempio PDF, consulta la pagina Tradurre documenti.
Prima di iniziare
Prima di iniziare a utilizzare l'API Cloud Translation, devi avere un progetto in cui sia abilitata l'API Cloud Translation e disporre di una chiave privata con le credenziali appropriate. Puoi anche installare librerie client per linguaggi di programmazione comuni per aiutarti a effettuare chiamate all'API. Per ulteriori informazioni, consulta la pagina Configurazione.
Confronto tra i modelli
Quando richiedi una traduzione da Cloud Translation - Advanced, puoi specificare il modello di traduzione da utilizzare. Se non è specificato alcun modello, viene utilizzato il modello nmt
.
Modello | La soluzione migliore | Esempi |
---|---|---|
Modello neurale di traduzione automatica (NMT) |
Casi d'uso generali di testo, come contenuti di siti web comuni che non riguardano un dominio specifico, ad esempio articoli di notizie. |
Articoli di notizie, social media, applicazioni di chat, recensioni |
Modello AutoML Translation | Testo specifico del dominio. I clienti forniscono dati di addestramento specifici per i propri casi d'uso, con determinate coppie di lingue, al fine di personalizzare il modello NMT di Google per il dominio. | Notizie finanziarie, documenti tecnici e qualsiasi testo che utilizzi termini e tecnicismi unici per quel campo. |
Devi specificare il modello di traduzione utilizzando l'ID modello. Per il modello NMT, l'ID modello è general/nmt
. Consulta la sezione successiva per informazioni sugli ID del modello AutoML Translation.
Traduzione di testo
Il testo inserito può essere testo normale o HTML. L'API Cloud Translation non traduce i tag HTML nell'input, ma solo il testo che appare tra i tag. Nella misura possibile, l'output conserva i tag HTML (non tradotti), con il testo tradotto tra i tag, a causa delle differenze tra le lingue di origine e di destinazione. L'ordine dei tag HTML nell'output potrebbe differire dall'ordine nel testo di input a causa delle modifiche all'ordine delle parole nella traduzione.
Traduzione di stringhe di input
REST &CMD LINE
Per tradurre un testo, effettua una richiesta POST
e fornisci un testo JSON nel corpo della richiesta
che identifichi la lingua di origine (source_language_code
), la lingua di destinazione (target_language_code
) e il testo di cui tradurre
(contents
). Puoi fornire più stringhe di testo da tradurre includendo
le parti nel codice JSON (vedi l'esempio). Per identificare le lingue di origine e di destinazione, utilizza i loro codici ISO-639-1.
Di seguito è riportato un esempio di richiesta POST
tramite
curl
o PowerShell. L'esempio utilizza il token di accesso per un account di servizio configurato per il progetto utilizzando l'interfaccia a riga di comando di Google Cloud.
Per istruzioni sull'installazione dell'interfaccia a riga di comando di Google Cloud, sulla configurazione di un progetto con un account di servizio e su come ottenere un token di accesso, consulta la pagina Configurazione.
Prima di utilizzare uno qualsiasi dei dati della richiesta, effettua le seguenti sostituzioni:
- PROJECT_NUMBER_OR_ID: ID o numero del progetto Google Cloud
Metodo HTTP e URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID:translateText
Corpo JSON richiesta:
{ "sourceLanguageCode": "en", "targetLanguageCode": "ru", "contents": ["Dr. Watson, come here!", "Bring me some coffee!"] }
Per inviare la richiesta, scegli una delle seguenti opzioni:
Curling
Salva il corpo della richiesta in un file denominato request.json
ed esegui il seguente comando:
curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID:translateText "
PowerShell
Salva il corpo della richiesta in un file denominato request.json
ed esegui il seguente comando:
$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID:translateText " | Select-Object -Expand Content
Dovresti ricevere una risposta JSON simile alla seguente:
{ "translations": [ { "translatedText": "Доктор Ватсон, иди сюда!", }, { "translatedText": "Принеси мне кофе!", } ] }
L'array translations
contiene due campi translatedText
con traduzioni fornite nella lingua targetLanguageCode
richiesta (ru
: russo). Le traduzioni sono elencate nello stesso ordine dell'array di origine corrispondente nella richiesta.
Go
Prima di provare questo esempio, segui le istruzioni per la configurazione di Go nella guida rapida alla traduzione con le librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Translation Go.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida alla traduzione con le librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java Translation.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida alla traduzione con le librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Node.js di Translation.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida alla traduzione con le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python di traduzione.
Lingue aggiuntive
C#: Segui le istruzioni per la configurazione di C# nella pagina delle librerie client e consulta la documentazione di riferimento per la traduzione per .NET.
PHP: segui le istruzioni per la configurazione di PHP nella pagina delle librerie client e consulta la documentazione di riferimento per la traduzione per PHP.
Ruby: segui le istruzioni di configurazione di Rubby nella pagina delle librerie client e consulta la documentazione di riferimento per la traduzione per Ruby.
Traduzione di testo con un modello personalizzato di AutoML Translation
REST &CMD LINE
Questo esempio traduce il testo utilizzando un modello AutoML Translation il cui ID modello è
TRL1395675701985363739
. Puoi ottenere l'ID modello per un modello AutoML Translation dall'elenco dei modelli nell'interfaccia utente di AutoML Translation o dalla risposta API quando esegui l'addestramento del modello.
Prima di utilizzare uno qualsiasi dei dati della richiesta, effettua le seguenti sostituzioni:
- PROJECT_NUMBER_OR_ID: ID o numero del progetto Google Cloud
Metodo HTTP e URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/us-central1:translateText
Corpo JSON richiesta:
{ "model": "projects/PROJECT_NUMBER_OR_ID/locations/us-central1/models/TRL1395675701985363739", "sourceLanguageCode": "en", "targetLanguageCode": "ru", "contents": ["Dr. Watson, please discard your trash. You've shared unsolicited email with me. Let's talk about spam and importance ranking in a confidential mode."] }
Per inviare la richiesta, scegli una delle seguenti opzioni:
Curling
Salva il corpo della richiesta in un file denominato request.json
ed esegui il seguente comando:
curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/us-central1:translateText "
PowerShell
Salva il corpo della richiesta in un file denominato request.json
ed esegui il seguente comando:
$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/us-central1:translateText " | Select-Object -Expand Content
Dovresti ricevere una risposta JSON simile alla seguente:
{ "translation": { "translatedText": "Доктор Ватсон, пожалуйста, откажитесь от своего мусора. Вы поделились нежелательной электронной почтой со мной. Давайте поговорим о спаме и важности рейтинга в конфиденциальном режиме.", "model": "projects/project-number/locations/us-central1/models/TRL1395675701985363739" } }
Go
Prima di provare questo esempio, segui le istruzioni per la configurazione di Go nella guida rapida alla traduzione con le librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Translation Go.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida alla traduzione con le librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java Translation.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida alla traduzione con le librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Node.js di Translation.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida alla traduzione con le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python di traduzione.
Lingue aggiuntive
C#: Segui le istruzioni per la configurazione di C# nella pagina delle librerie client e consulta la documentazione di riferimento per la traduzione per .NET.
PHP: segui le istruzioni per la configurazione di PHP nella pagina delle librerie client e consulta la documentazione di riferimento per la traduzione per PHP.
Ruby: segui le istruzioni di configurazione di Rubby nella pagina delle librerie client e consulta la documentazione di riferimento per la traduzione per Ruby.
Utilizzare il parametro del modello
REST &CMD LINE
Puoi specificare il modello da utilizzare per la traduzione utilizzando il parametro di ricerca model
. Ad esempio, specifica nmt
per utilizzare il modello NMT.
L'esempio seguente mostra come utilizzare il parametro model
in una richiesta
di traduzione.
Prima di utilizzare uno qualsiasi dei dati della richiesta, effettua le seguenti sostituzioni:
- PROJECT_NUMBER_OR_ID: ID o numero del progetto Google Cloud
Metodo HTTP e URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/global:translateText
Corpo JSON richiesta:
{ "model": "projects/PROJECT_NUMBER_OR_ID/locations/global/models/general/nmt", "sourceLanguageCode": "en", "targetLanguageCode": "de", "contents": ["Come here!"] }
Per inviare la richiesta, scegli una delle seguenti opzioni:
Curling
Salva il corpo della richiesta in un file denominato request.json
ed esegui il seguente comando:
curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/global:translateText "
PowerShell
Salva il corpo della richiesta in un file denominato request.json
ed esegui il seguente comando:
$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/global:translateText " | Select-Object -Expand Content
Dovresti ricevere una risposta JSON simile alla seguente:
{ "translations": [ { "translatedText": "Komm her!", "model": "projects/project-number/locations/global/models/general/nmt" } ] }
Risorse aggiuntive
- Per la risoluzione dei problemi o degli errori comuni, consulta la pagina Risoluzione dei problemi.