Cloud Translation - Advanced è ottimizzato per la personalizzazione e i casi d'uso di contenuti in formato lungo. Oltre al modello di traduzione automatica neurale (NMT), Advanced ti offre l'accesso al modello linguistico di grandi dimensioni (LLM) per la traduzione (il modello di traduzione in stile LLM più recente e di massima qualità di Google) e la possibilità di creare modelli personalizzati.
Cloud Translation - Advanced offre anche funzionalità avanzate di traduzione di testi come la traduzione di documenti e la creazione di glossari per garantire che la terminologia specifica del dominio venga tradotta correttamente.
Prima di iniziare
Prima di poter iniziare a utilizzare l'API Cloud Translation, devi disporre di un progetto in cui l'API Cloud Translation è abilitata e devi disporre delle credenziali appropriate. Puoi anche installare librerie client per i linguaggi di programmazione più comuni per facilitare le chiamate all'API. Per ulteriori informazioni, consulta la pagina Configurazione.
Per istruzioni sull'installazione di Google Cloud CLI, sulla configurazione di un progetto con un account di servizio e sull'ottenimento di 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.
Traduci testo
Per le traduzioni, l'input 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. L'output conserva i tag HTML (non tradotti), con il testo tradotto tra i tag nella misura possibile a causa delle differenze tra le lingue di origine e di destinazione.
Tradurre le stringhe di input
REST
Per tradurre il testo, invia una richiesta POST
e fornisci il codice 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 codice JSON (vedi esempio). Identifichi 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
Google Cloud CLI.
Per istruzioni sull'installazione di Google Cloud CLI, sulla configurazione di un progetto con un account di servizio e sull'ottenimento di 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 Google Cloud progetto
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 nella guida rapida di Cloud Translation per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Translation Go.
Per autenticarti in Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida di Cloud Translation per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Translation Java.
Per autenticarti in Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida di Cloud Translation per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Translation Node.js.
Per autenticarti in Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida di Cloud Translation per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Translation Python.
Per autenticarti in Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Linguaggi aggiuntivi
C#: Segui le istruzioni di configurazione di C# nella pagina delle librerie client e poi visita 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 visita la documentazione di riferimento di Cloud Translation per Ruby.
Tradurre 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 un ID modello di
1395675701985363739
. Puoi ottenere l'ID modello per un modello personalizzato dall'elenco
dei modelli nella console Google Cloud o dalla risposta dell'API o dalla
pagina Pantheon corrispondente quando addestri il modello. Per utilizzare l'LLM
di traduzione, specifica general/translation-llm
come ID modello. Per utilizzare l'LLM di traduzione personalizzato (anteprima pubblica), specifica model/translation-llm-custom/{model-id}
come ID modello.
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- PROJECT_ID: il tuo ID 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 di queste 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 nella guida rapida di Cloud Translation per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Translation Go.
Per autenticarti in Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida di Cloud Translation per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Translation Java.
Per autenticarti in Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida di Cloud Translation per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Translation Node.js.
Per autenticarti in Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida di Cloud Translation per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Translation Python.
Per autenticarti in Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Linguaggi aggiuntivi
C#: Segui le istruzioni di configurazione di C# nella pagina delle librerie client e poi visita 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 visita la documentazione di riferimento di Cloud Translation per Ruby.
Traslitterazione
La traslitterazione è un'impostazione di configurazione del metodo translateText
. Quando
attivi la traslitterazione, traduci il testo romanizzato (alfabeto latino) 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 testo romanizzato. Se mescoli testo romanizzato con testo non romanizzato, Cloud Translation non può garantire traduzioni coerenti e corrette.
Considerazioni
La traslitterazione si differenzia dalle traduzioni di testo standard per i seguenti motivi:
- La traslitterazione supporta un numero limitato di lingue. Per ulteriori informazioni, consulta la colonna Traslitterazione 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 traslitterazione 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 Google Cloud progetto.
- LOCATION: la regione in cui vuoi eseguire questa operazione. Ad esempio,
us-central1
. - SOURCE_LANGUAGE: (facoltativo) il codice lingua del testo di input. Se noto, impostalo su uno dei codici lingua elencati in Supporto delle lingue.
- TARGET_LANGUAGE: la lingua di destinazione in cui tradurre il testo di input. 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 nella risoluzione di problemi o errori comuni, consulta la pagina Risoluzione dei problemi.