Cloud Translation - Advanced supporta la traduzione del testo utilizzando modelli personalizzati e la creazione di glossari per garantire che l'API Cloud Translation traduca correttamente la terminologia specifica del dominio di un cliente.
Per istruzioni su come installare Google Cloud CLI, configurare un progetto con un account di servizio e ottenere un token di accesso, consulta la pagina Configurazione. Se prevedi di utilizzare un glossario o le funzionalità di batch, devi anche creare un bucket Cloud Storage e concedere al tuo account di servizio l'accesso.
Per tradurre documenti formattati, come i PDF, consulta Tradurre documenti.
Prima di iniziare
Prima di poter iniziare a utilizzare l'API Cloud Translation, devi avere un progetto in cui è attivata l'API Cloud Translation e devi disporre delle 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 dei modelli
Quando richiedi una traduzione da Cloud Translation - Advanced, puoi specificare quale
modello di traduzione utilizzare. Se non viene specificato alcun modello, viene utilizzato il modello nmt
.
Modello | ID modello | Vestibilità ottimale | Esempi |
---|---|---|---|
Modello di traduzione automatica neurale (NMT) | general/nmt |
Casi d'uso di testo generico, come i contenuti comuni dei siti web che non sono specifici per un dominio, ad esempio gli articoli di notizie. |
Articoli di notizie, Social media, App di chat, Recensioni |
Modello linguistico di grandi dimensioni (LLM) per la traduzione (anteprima) | general/translation-llm |
Modello alternativo offerto in Cloud Translation - Avanzata in due modalità. Traduzione di testi per casi d'uso generici, come i messaggi di conversazione, che non richiedono personalizzazione. E la traduzione adattiva, che supporta la personalizzazione in tempo reale utilizzando un set di dati con esempi. |
Articoli di notizie, Social media, App di chat, Recensioni |
Modello AutoML Translation | L'ID modello viene generato al termine dell'addestramento del modello. | Testo specifico del dominio. I clienti forniscono dati di addestramento specifici per i loro casi d'uso, per determinate coppie di lingue, per personalizzare il modello di NMT di Google in base alle finalità del dominio. | Notizie finanziarie, documenti tecnici, qualsiasi testo che utilizzi termini e linguaggio tecnico specifici di quel campo. |
Considerazione
Ogni modello supporta le proprie lingue impostate. Verifica che le lingue di origine e di destinazione siano supportate. Per ulteriori informazioni, vedi Lingue supportate.
Traduzione di testo
Per le traduzioni, l'input può essere in testo normale o HTML. L'API Cloud Translation non traduce i tag HTML nell'input, ma solo il testo visualizzato tra i tag. L'output conserva i tag HTML (non tradotti), con il testo tradotto tra i tag, nella misura del possibile a causa delle differenze tra le lingue di origine e di destinazione.
Traduzione delle stringhe di input
REST
Per tradurre il testo, effettua una richiesta POST
e fornisci JSON nel corpo della richiesta
che identifica la lingua di partenza (source_language_code
), la lingua di destinazione (target_language_code
) e il testo da tradurre
(contents
). Puoi fornire più stringhe di testo da tradurre includendole
nel tuo JSON (vedi esempio). Identifica le lingue di origine e di destinazione utilizzando i relativi codici ISO-639.
Di seguito è riportato un esempio di richiesta POST
mediante curl
o PowerShell. L'esempio utilizza il token di accesso per un account di servizio configurato per il progetto utilizzando Google Cloud CLI.
Per istruzioni su come installare Google Cloud CLI, configurare un progetto con un account di servizio e ottenere un token di accesso, consulta la pagina Configurazione.
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- PROJECT_NUMBER_OR_ID: l'ID numerico o alfanumerico del tuo progetto Google Cloud
Metodo HTTP e URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID:translateText
Corpo JSON della richiesta:
{ "sourceLanguageCode": "en", "targetLanguageCode": "ru", "contents": ["Dr. Watson, come here!", "Bring me some coffee!"] }
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "translations": [ { "translatedText": "Доктор Ватсон, иди сюда!", }, { "translatedText": "Принеси мне кофе!", } ] }
L'array translations
contiene due campi translatedText
con le 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 di configurazione di Go riportate nella guida rapida di Cloud Translation che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Translation Go.
Per autenticarti a Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java riportate nella guida rapida di Cloud Translation che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Translation Java.
Per autenticarti a Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js riportate nella guida rapida di Cloud Translation che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Translation Node.js.
Per autenticarti a Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python riportate nella guida rapida di Cloud Translation che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Translation Python.
Per autenticarti a Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Linguaggi aggiuntivi
C#: segui le istruzioni di configurazione per C# nella pagina delle librerie client e poi consulta la documentazione di riferimento di Cloud Translation per .NET.
PHP: segui le istruzioni di configurazione di PHP nella pagina delle librerie client e poi consulta la documentazione di riferimento di Cloud Translation per PHP.
Ruby: segui le istruzioni di configurazione di Ruby nella pagina delle librerie client e poi consulta la documentazione di riferimento di Cloud Translation per Ruby.
Traduzione di testo utilizzando un modello specifico
REST
Puoi specificare il modello da utilizzare per la traduzione utilizzando il parametro di query
model
.
L'esempio seguente traduce il testo utilizzando un modello personalizzato con ID modello 1395675701985363739
. Puoi ottenere l'ID di un modello personalizzato dall'elenco
di modelli nella console Google Cloud o dalla risposta dell'API quando addestri
il modello. Per utilizzare l'LLM di traduzione, specifica general/translation-llm
come ID modello.
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- PROJECT_ID: l'ID del tuo progetto Google Cloud.
- LOCATION: la regione in cui si trova il modello personalizzato, ad esempio
us-central1
.
Metodo HTTP e URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION:translateText
Corpo JSON della richiesta:
{ "model": "projects/PROJECT_ID/locations/LOCATION/models/1395675701985363739", "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:
curl
Salva il corpo della richiesta in un file denominato request.json
,
quindi esegui il comando seguente:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: PROJECT_ID" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION:translateText"
PowerShell
Salva il corpo della richiesta in un file denominato request.json
,
quindi esegui il comando seguente:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION:translateText" | Select-Object -Expand Content
Dovresti ricevere una risposta JSON simile alla seguente:
{ "translation": { "translatedText": "Доктор Ватсон, пожалуйста, откажитесь от своего мусора. Вы поделились нежелательной электронной почтой со мной. Давайте поговорим о спаме и важности рейтинга в конфиденциальном режиме.", "model": "projects/PROJECT_NUMBER/locations/LOCATION/models/1395675701985363739" } }
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go riportate nella guida rapida di Cloud Translation che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Translation Go.
Per autenticarti a Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java riportate nella guida rapida di Cloud Translation che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Translation Java.
Per autenticarti a Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js riportate nella guida rapida di Cloud Translation che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Translation Node.js.
Per autenticarti a Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python riportate nella guida rapida di Cloud Translation che utilizza le librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Translation Python.
Per autenticarti a Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Linguaggi aggiuntivi
C#: segui le istruzioni di configurazione per C# riportate nella pagina delle librerie client e consulta la documentazione di riferimento di Cloud Translation per .NET.
PHP: segui le istruzioni di configurazione di PHP nella pagina delle librerie client e poi consulta la documentazione di riferimento di Cloud Translation per PHP.
Ruby: segui le istruzioni di configurazione di Ruby nella pagina delle librerie client e poi consulta la documentazione di riferimento di Cloud Translation per Ruby.
Traslitterazione
La traslitterazione è un'impostazione di configurazione nel metodo translateText
. Quando attivi la traslitterazione, traduci il testo romanizzato (in caratteri latini) direttamente in una lingua di destinazione. Ad esempio, puoi tradurre il testo giapponese romanizzato direttamente in inglese, spagnolo o cinese. Le traduzioni risultanti sono nel sistema di scrittura della lingua di destinazione.
Nelle richieste di traslitterazione, includi solo il testo romanizzato. Se combini testo romanizzato con testo non romanizzato, Cloud Translation non può garantire traduzioni coerenti e corrette.
Considerazioni
La trascrizione differisce dalle traduzioni di testo standard nei seguenti modi:
- La trascrizione supporta un numero limitato di lingue. Per ulteriori informazioni, consulta la colonna Trascrizione nella pagina Lingue supportate.
- Il tipo MIME deve essere
text/plain
. HTML non è supportato. - La traslitterazione è supportata solo dal modello standard predefinito. I modelli personalizzati non sono supportati.
- La trascrizione ha una quota di contenuti predefinita inferiore. Per ulteriori informazioni, consulta Quote e limiti.
REST
Imposta il campo transliteration_config
sul metodo
translateText
.
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- PROJECT_NUMBER_OR_ID: l'ID numerico o alfanumerico del tuo progetto Google Cloud.
- LOCATION: regione in cui vuoi eseguire questa operazione. Ad esempio,
us-central1
. - SOURCE_LANGUAGE: (Facoltativo) il codice lingua del testo inserito. Se noto, imposta uno dei codici lingua elencati in Supporto delle lingue.
- TARGET_LANGUAGE: la lingua di destinazione in cui tradurre il testo inserito. Impostato su uno dei codici lingua elencati in Supporto delle lingue.
- SOURCE_TEXT: testo romanizzato nella lingua di origine da tradurre.
Metodo HTTP e URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:translateText
Corpo JSON della richiesta:
{ "source_language_code": "SOURCE_LANGUAGE", "target_language_code": "TARGET_LANGUAGE", "contents": "SOURCE_TEXT", "mime_type": "text/plain", "transliteration_config": { "enable_transliteration": true} }
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "translations": [ { "translatedText": "TRANSLATED_TEXT", } ] }
Risorse aggiuntive
- Per assistenza sulla risoluzione di problemi o errori comuni, consulta la pagina Risoluzione dei problemi.