Traduzione di testo
Questa pagina mostra come tradurre un testo di esempio con le versioni Basic e Advanced di Cloud Translation.
Prima di iniziare
Prima di poter iniziare a utilizzare l'API Cloud Translation, devi avere un progetto in cui sia abilitata l'API Cloud Translation e le credenziali appropriate. Puoi anche installare librerie client per i linguaggi di programmazione più comuni per facilitare le chiamate all'API. Per saperne di più, consulta la pagina Configurazione.
Scegli la versione dell'API che preferisci:
Esegui la traduzione del testo
Cloud Translation - Advanced è ottimizzato per la personalizzazione e per i casi d'uso di contenuti in formato lungo. Oltre al modello di traduzione automatica neurale (NMT), la versione Advanced ti offre l'accesso al modello LLM di traduzione (il modello di traduzione in stile LLM di Google più recente e di qualità più elevata) e la possibilità di creare modelli personalizzati.
Cloud Translation - Advanced fornisce anche funzionalità avanzate di traduzione del testo, come la traduzione di documenti e la creazione di glossari per garantire che la terminologia specifica del tuo dominio venga tradotta correttamente.
Per le traduzioni con la versione Advanced, 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 in base alle differenze tra le lingue di origine e di destinazione.
Esempio di traduzione di testo
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). 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 service account configurato per il progetto utilizzando Google CloudGoogle Cloud CLI.
Per istruzioni sull'installazione di Google Cloud CLI, sulla configurazione di un progetto con un service account e sul recupero di un token di accesso, consulta la pagina Configurazione.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- 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 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 eseguire l'autenticazione in Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per saperne di più, 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 eseguire l'autenticazione in Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per saperne di più, 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 eseguire l'autenticazione in Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per saperne di più, 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 eseguire l'autenticazione in Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per saperne di più, 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, poi consulta la documentazione di riferimento di Cloud Translation per .NET.
PHP: segui le istruzioni di configurazione di PHP nella pagina delle librerie client, poi consulta la documentazione di riferimento di Cloud Translation per PHP.
Ruby: segui le istruzioni di configurazione di Ruby nella pagina delle librerie client, poi consulta la documentazione di riferimento di Cloud Translation per Ruby.
Traduci il 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 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 sostituzioni seguenti:
- PROJECT_ID: l'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 ed esegui questo comando:
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 eseguire l'autenticazione in Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per saperne di più, 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 eseguire l'autenticazione in Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per saperne di più, 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 eseguire l'autenticazione in Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per saperne di più, 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 eseguire l'autenticazione in Cloud Translation, configura le Credenziali predefinite dell'applicazione. Per saperne di più, 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, poi consulta la documentazione di riferimento di Cloud Translation per .NET.
PHP: segui le istruzioni di configurazione di PHP nella pagina delle librerie client, poi consulta la documentazione di riferimento di Cloud Translation per PHP.
Ruby: segui le istruzioni di configurazione di Ruby nella pagina delle librerie client, 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 testo romanizzato (in alfabeto latino) direttamente in una lingua di destinazione. Ad esempio, puoi tradurre 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 differisce dalle traduzioni di testo standard per i seguenti aspetti:
- La traslitterazione supporta un numero limitato di lingue. Per saperne di più, 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 per i contenuti predefinita più bassa. Per saperne di più, consulta Quote e limiti.
REST
Imposta il campo transliteration_config sul metodo translateText.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PROJECT_NUMBER_OR_ID: l'ID numerico o alfanumerico del tuo progetto Google Cloud .
- LOCATION: la regione in cui vuoi eseguire questa operazione. Ad esempio:
us-central1. - SOURCE_LANGUAGE: (facoltativo) il codice lingua del documento di input. Se noto, impostalo su uno dei codici lingua elencati in Lingue supportate.
- TARGET_LANGUAGE: la lingua di destinazione in cui tradurre il testo di input. Impostala su uno dei codici lingua elencati in Lingue supportate.
- SOURCE_TEXT: il 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 ricevere assistenza per la risoluzione di problemi o errori comuni, consulta la pagina Risoluzione dei problemi.
- Per risposte a domande generali su Cloud Translation, consulta la pagina Domande frequenti di carattere generale.
- Cloud Translation è disponibile in due versioni. Per saperne di più su ogni versione, consulta Confronta le edizioni Basic e Advanced.