Cloud Translation - Advanced supporta la traduzione del testo utilizzando modelli e per creare glossari per garantire che L'API Cloud Translation traduce la terminologia specifica del dominio di un cliente in modo corretto.
Per istruzioni sull'installazione di Google Cloud CLI, configura un progetto con un l'account di servizio e ottenere un token di accesso, consulta pagina di configurazione. Se prevedi di utilizzare una o le funzionalità batch, devi inoltre creare un Cloud Storage bucket e concedere al tuo account di servizio l'accesso li annotino.
Per tradurre documenti formattati, ad esempio PDF, consulta la sezione Tradurre documenti.
Prima di iniziare
Per poter iniziare a utilizzare l'API Cloud Translation, devi avere un progetto con l'API Cloud Translation sia abilitata e devi disporre delle credenziali appropriate. Puoi installare anche librerie client per i linguaggi di programmazione più comuni chiamate all'API. Per ulteriori informazioni, consulta la pagina Configurazione.
Confronto tra modelli
Quando richiedi la traduzione da Cloud Translation - Advanced, puoi specificare quale
di traduzione automatica da 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 generici di testo, ad esempio contenuti comuni di siti web che non rientrano specifiche di un dominio, ad esempio. di notizie. |
Articoli, social media, applicazioni di chat, recensioni |
Modello linguistico di grandi dimensioni (LLM) di traduzione (anteprima) | general/translation-llm |
Modello alternativo offerto su Cloud Translation - Advanced in due modalità. La traduzione del testo per casi d'uso generici di testo, come conversazionali, che non richiedono la personalizzazione. E adattiva traduzione, che supporta la personalizzazione in tempo reale utilizzando set di dati con esempi. |
Articoli, social media, applicazioni di chat, recensioni |
Modello di traduzione AutoML | L'ID modello viene generato al termine dell'addestramento del modello. | Testo specifico per il dominio. I clienti forniscono dati di addestramento specifici per i propri casi d'uso, per determinate coppie di lingue, al fine di personalizzare il modello NMT di Google per lo scopo del dominio. | Notizie finanziarie, documenti tecnici, qualsiasi testo che utilizzi termini e gergale unico per quel campo. |
Considerazione
Ogni modello supporta le proprie lingue predefinite. Verifica che l'origine e la destinazione lingue supportate. Per ulteriori informazioni, consulta le sezioni Supportate lingue.
Traduzione di testo
Per le traduzioni, l'input può essere testo normale o HTML. API Cloud Translation non traduce nessun 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 i tag e lingue 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 origine (source_language_code
), il valore
lingua di destinazione (target_language_code
) e il testo da tradurre
(contents
). Puoi fornire più stringhe di testo da tradurre includendo
nel tuo file JSON (vedi esempio). Tu identifichi le lingue di origine e di destinazione
utilizzando i propri standard ISO-639
i codici.
Di seguito è riportato un esempio di richiesta POST
che utilizza
curl
o PowerShell. Nell'esempio viene utilizzato il token di accesso per un account di servizio
per il progetto utilizzando
Google Cloud CLI.
Per istruzioni sull'installazione di 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, effettua 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 delle seguenti opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "translations": [ { "translatedText": "Доктор Ватсон, иди сюда!", }, { "translatedText": "Принеси мне кофе!", } ] }
L'array translations
contiene due campi translatedText
con traslazioni
specificato nel campo targetLanguageCode
richiesto
lingua (ru
: russo). Le traduzioni vengono elencate nello stesso ordine delle
nell'array di origine corrispondente nella richiesta.
Go
Prima di provare questo esempio, segui le istruzioni per la configurazione di Go nel Guida rapida di Cloud Translation con librerie client. Per ulteriori informazioni, consulta API Cloud Translation Go documentazione di riferimento.
Per autenticarti su Cloud Translation, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni per la configurazione di Java nel Guida rapida di Cloud Translation con librerie client. Per ulteriori informazioni, consulta API Cloud Translation Java documentazione di riferimento.
Per autenticarti su Cloud Translation, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni per la configurazione di Node.js nel Guida rapida di Cloud Translation con librerie client. Per ulteriori informazioni, consulta API Cloud Translation Node.js documentazione di riferimento.
Per autenticarti su Cloud Translation, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nel Guida rapida di Cloud Translation con librerie client. Per ulteriori informazioni, consulta API Cloud Translation Python documentazione di riferimento.
Per autenticarti su Cloud Translation, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Linguaggi aggiuntivi
C#: Segui le Istruzioni per la configurazione di C# Nella pagina delle librerie client e poi visita Documentazione di riferimento di Cloud Translation per .NET.
PHP Segui le Istruzioni per la configurazione dei file PHP Nella pagina delle librerie client e poi visita Documentazione di riferimento di Cloud Translation per PHP.
Rubino: Segui le Istruzioni per la configurazione di Ruby Nella pagina delle librerie client e poi visita Documentazione di riferimento di Cloud Translation per Ruby.
Traduzione di testo utilizzando un modello specifico
REST
Puoi specificare quale modello utilizzare per la traduzione utilizzando il metodo
model
parametro di query.
L'esempio seguente traduce il testo utilizzando un modello personalizzato con ID modello pari a
1395675701985363739
. Puoi ottenere l'ID modello di un modello personalizzato dall'elenco
di modelli nella console Google Cloud o dalla risposta API durante l'addestramento
del modello. Per utilizzare l'LLM di traduzione, specifica general/translation-llm
come
l'ID modello.
Prima di utilizzare i dati della richiesta, effettua 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
.
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
.
ed esegui questo comando:
$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 per la configurazione di Go nel Guida rapida di Cloud Translation con librerie client. Per ulteriori informazioni, consulta API Cloud Translation Go documentazione di riferimento.
Per autenticarti su Cloud Translation, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni per la configurazione di Java nel Guida rapida di Cloud Translation con librerie client. Per ulteriori informazioni, consulta API Cloud Translation Java documentazione di riferimento.
Per autenticarti su Cloud Translation, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Prima di provare questo esempio, segui le istruzioni per la configurazione di Node.js nel Guida rapida di Cloud Translation con librerie client. Per ulteriori informazioni, consulta API Cloud Translation Node.js documentazione di riferimento.
Per autenticarti su Cloud Translation, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nel Guida rapida di Cloud Translation con librerie client. Per ulteriori informazioni, consulta API Cloud Translation Python documentazione di riferimento.
Per autenticarti su Cloud Translation, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Linguaggi aggiuntivi
C#: Segui le Istruzioni per la configurazione di C# Nella pagina delle librerie client e poi visita Documentazione di riferimento di Cloud Translation per .NET.
PHP Segui le Istruzioni per la configurazione dei file PHP Nella pagina delle librerie client e poi visita Documentazione di riferimento di Cloud Translation per PHP.
Rubino: Segui le Istruzioni per la configurazione di Ruby Nella pagina delle librerie client e poi visita Documentazione di riferimento di Cloud Translation per Ruby.
Traslitterazione
La traslitterazione è un'impostazione di configurazione nel metodo translateText
. Quando
attivi la traslitterazione, traduci direttamente il testo romanizzato (alfabeto latino)
a una lingua di destinazione. Ad esempio, puoi tradurre un testo in giapponese romanizzato
direttamente in inglese, spagnolo o cinese. Le traduzioni risultanti sono
il 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 coerenza e traduzioni corrette.
Considerazioni
La traslitterazione differisce dalle traduzioni di testo standard per i seguenti aspetti:
- La traslitterazione supporta un numero limitato di lingue. Per ulteriori informazioni, consulta la colonna Traslitterazione nella sezione Supportato lingue.
- Il tipo MIME deve essere
text/plain
. HTML non supportato. - La traslitterazione è supportata solo dal modello standard predefinito. Modelli personalizzati non sono supportati.
- La traslitterazione ha una quota di contenuti predefinita inferiore. Per ulteriori informazioni, vedi Quote e limiti.
REST
Imposta il campo transliteration_config
nella
translateText
.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- PROJECT_NUMBER_OR_ID: l'ID numerico o alfanumerico del progetto Google Cloud.
- LOCATION: regione in cui vuoi eseguire questa operazione. Per
ad esempio
us-central1
. - SOURCE_LANGUAGE: (facoltativo) il codice lingua dell'input testo. Se lo conosci, imposta uno dei codici lingua elencati nella sezione Supporto lingua.
- TARGET_LANGUAGE: la lingua di destinazione in cui tradurre l'input a. Imposta uno dei codici lingua elencati nella sezione Supporto lingua.
- SOURCE_TEXT: testo romanizzato nella lingua di origine in traduci.
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 delle seguenti 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 le Risoluzione dei problemi.