Panoramica dell'API Cloud Translation
L'API Cloud Translation può tradurre testi tra più di 100 coppie di lingue. Se non conosci la lingua del testo di origine, l'API Cloud Translation può rilevarla per te. Per un elenco di tutte le lingue supportate, consulta Lingue supportate.
In qualità di organizzazione aziendale, puoi includere il testo tradotto nei workflow interni esistenti. Ad esempio, potresti avere un team di assistenza globale che riceve richieste di assistenza dai clienti in molte lingue diverse. Puoi aggiungere l'API Cloud Translation al tuo flusso di lavoro per tradurre le richieste di assistenza dei clienti nella lingua parlata dai membri del tuo team di assistenza. Utilizzando l'API Cloud Translation, migliori l'efficienza complessiva del tuo team di assistenza perché non deve tradurre manualmente il testo o fare affidamento su altri.
L'API Cloud Translation è scalabile in modo efficiente e consente traduzioni senza limitazioni giornaliere sul numero di caratteri. Tuttavia, esistono limitazioni relative alle dimensioni dei contenuti per ogni richiesta e alla frequenza delle richieste. Inoltre, puoi utilizzare i limiti di quota per gestire il budget. Per saperne di più, consulta Quote e limiti.
L'API Cloud Translation è disponibile in due versioni diverse, ovvero una versione Basic e una versione Advanced. Per un elenco delle diverse funzionalità supportate da ciascuna, consulta il confronto tra le versioni.
API Cloud Translation - Basic
È possibile accedere all'edizione Basic tramite le librerie client v2 e richiede una configurazione minima. Accetta chiavi API per l'autenticazione e service account e utilizza il modello di traduzione automatica neurale (NMT) preaddestrato di Google senza modifiche. È ideale per le applicazioni che devono tradurre contenuti informali generati dagli utenti, come chat, social media o commenti.
Per impostazione predefinita, l'API Cloud Translation utilizza la versione Basic, che Google aggiorna a intervalli regolari man mano che diventano disponibili ulteriori dati di addestramento e tecniche migliori.
Se stai pianificando un nuovo progetto, ti consigliamo di scegliere la versione Advanced per usufruire di una maggiore sicurezza, di più funzionalità e dei nuovi miglioramenti del servizio che la versione Advanced continuerà a offrire in futuro.
API Cloud Translation - Advanced
È possibile accedere alla versione Advanced tramite le librerie client v3 e richiede l'autenticazione del account di servizio integrata con i ruoli IAM. Offre una scelta di modelli, tra cui il modello LLM di traduzione, il modello NMT e le personalizzazioni NMT. Offre inoltre funzionalità come glossari, traduzione batch, traduzione di documenti e altro ancora.
Le funzionalità principali dell'API Cloud Translation - Advanced sono:
Accesso a più modelli: scegli il modello più adatto alle tue esigenze tra diversi modelli di traduzione all'avanguardia, come l'LLM di traduzione, il modello di traduzione automatica neurale (NMT) di Google, i modelli di traduzione adattiva o i modelli NMT personalizzati che tu o qualcun altro avete creato.
Glossari: crea un dizionario personalizzato per tradurre in modo corretto e coerente i termini specifici del dominio.
Richieste batch: esegui richieste asincrone per tradurre grandi quantità di testo.
Traduzione di documenti: traduci documenti, ad esempio file PDF, per preservare il formato e il layout originali.
Ruoli IAM: proteggi le tue richieste di traduzione utilizzando Identity and Access Management. Crea service account e concedi loro le autorizzazioni aggiungendo ruoli IAM. L'API Cloud Translation - Advanced non supporta le chiavi API.
Etichette: aggiungi etichette definite dall'utente (coppie chiave/valore) alle tue richieste di traduzione per monitorare meglio l'utilizzo e ottenere report di fatturazione granulari.
Endpoint regionale: esercita il controllo sul luogo in cui le risorse per il tuo progetto vengono archiviate ed elaborate.
Glossari
Un glossario è un dizionario personalizzato che l'API Cloud Translation - Advanced utilizza per tradurre in modo corretto e coerente termini specifici del dominio, entità denominate e altri tipi di termini specifici. Ad esempio, puoi utilizzare un glossario per specificare una traduzione specifica per termini come "Google Summer of Code", "modalità confidenziale di Gmail" o "report sul rendimento dei posizionamenti".
Puoi anche utilizzare i glossari per impedire la traduzione di determinate parole, come prestiti o nomi dei prodotti. Per informazioni su come utilizzare i glossari, consulta Creazione e utilizzo di glossari.
Richieste batch
Le richieste di traduzione batch sono richieste asincrone che traducono l'input dai bucket Cloud Storage. L'API Cloud Translation - Advanced esegue la traduzione batch come operazione a lunga esecuzione e scrive l'output in un bucket Cloud Storage da te specificato. Le richieste inline per la traduzione batch non sono supportate.
Per informazioni su come effettuare richieste batch, consulta la sezione Richieste batch (Advanced).
Document Translation
Document Translation ti consente di tradurre direttamente i documenti esistenti, come i file PDF e DOCX, in una lingua di destinazione. Document Translation conserva il formato originale in modo che i documenti tradotti abbiano lo stesso layout e formato dei documenti originali. Ad esempio, Document Translation mantiene le interruzioni di paragrafo e le intestazioni in modo che i contenuti tradotti siano suddivisi come nel documento originale.
Le funzionalità dell'API Cloud Translation - Advanced, come i glossari e i modelli AutoML, funzionano anche con Document Translation. Ad esempio, se hai un modello AutoML esistente che utilizzi per le traduzioni di testo, puoi utilizzare lo stesso modello per Document Translation. Per saperne di più sui tipi di file supportati e su come tradurre i documenti, consulta Traduci documenti.
Selezione del modello e modelli AutoML
La selezione del modello dell'API Cloud Translation - Advanced ti consente di scegliere dinamicamente il modello giusto per la tua applicazione tra l'LLM di traduzione (che puoi anche personalizzare ulteriormente per le traduzioni adattive), il modello NMT di Google o i modelli AutoML Translation personalizzati, a seconda del contesto e dei contenuti che stai traducendo.
Crea un modello personalizzato utilizzando AutoML Translation per ottenere traduzioni più accurate per la terminologia specifica del dominio. Puoi quindi utilizzare il modello risultante nell'API Cloud Translation - Advanced per tradurre il testo.
Per informazioni sull'utilizzo dei modelli personalizzati per tradurre il testo, consulta Traduzione di testo (Advanced).
Ruoli IAM
L'API Cloud Translation - Advanced si integra con IAM per fornire ulteriore sicurezza per le richieste di traduzione, consentire il controllo dell'accesso granulare e supportare l'integrazione con AutoML Translation.
Devi aggiungere utenti e service account a uno dei seguenti ruoli per concedere a questi account l'accesso all'API Cloud Translation - Advanced. Per informazioni sulla creazione dei service account, consulta Creazione e gestione dei service account nella documentazione IAM.
| Ruolo | ID ruolo | Descrizione |
|---|---|---|
| Cloud Translation API Viewer | roles/cloudtranslate.viewer |
Può accedere alle operazioni get e list. |
| Cloud Translation API User | roles/cloudtranslate.user |
Include le autorizzazioni di |
| Cloud Translation API Editor | roles/cloudtranslate.editor |
Include le autorizzazioni di |
| Cloud Translation API Admin | roles/cloudtranslate.admin |
Include le autorizzazioni di |
Per visualizzare un elenco delle autorizzazioni contenute in ogni ruolo, consulta la sezione Informazioni sui ruoli.
Questi ruoli preconfigurati coprono molti casi d'uso tipici. Tuttavia, potresti aver bisogno di un ruolo che includa un set personalizzato di autorizzazioni. Ad esempio, potresti voler creare un ruolo che consenta a un utente di creare un glossario in un progetto, senza consentirgli di eliminare o aggiornare i glossari esistenti nel progetto. In questi casi, puoi creare un ruolo personalizzato IAM che soddisfi le tue esigenze.
Per informazioni sulla gestione dei ruoli IAM, consulta Concessione, modifica e revoca dell'accesso alle risorse e Concessione dei ruoli ai service account.
Etichette
L'API Cloud Translation - Advanced supporta l'aggiunta di etichette definite dall'utente (coppie chiave/valore) alle richieste TranslateText, BatchTranslateText e DetectLanguage.
Le informazioni sull'utilizzo di una richiesta vengono inoltrate al sistema di fatturazione, dove puoi suddividere i costi di fatturazione filtrando in base alle etichette.
Per saperne di più sulle etichette definite dall'utente, consulta Creazione di report sull'utilizzo con etichette (Advanced).
Endpoint a livello di regione
Per impostazione predefinita, l'API Cloud Translation - Advanced archivia ed elabora le risorse in una località globale, il che significa che non è garantito che le risorse rimangano all'interno di una località specifica. Anziché utilizzare l'endpoint globale predefinito, puoi utilizzare un endpoint regionale per mantenere le risorse in una località specifica, ad esempio l'Unione Europea. Per saperne di più, consulta Specifica un endpoint regionale.
Confronto tra le versioni
La tabella seguente mostra le funzionalità disponibili in ogni versione.
| Funzionalità | Basic | Advanced |
|---|---|---|
| Traduzione con il modello NMT | ||
| Traduzione con l'LLM di traduzione | ||
| Traduzione con modelli di traduzione adattiva | ||
| Traduzione con modelli personalizzati | ||
| Traduzione di più stringhe in un'unica richiesta | ||
| Traduzioni batch con Cloud Storage | ||
| Traduzione di documenti | ||
| Supporto dei glossari (terminologia di controllo) | ||
| Addestramento di modelli personalizzati | ||
| Rilevamento della lingua | ||
| API REST integrata | ||
| API gRPC integrata | ||
| Service Account | ||
| Chiave API | ||
| Audit logging | ||
| Supporto di HTML | ||
| Supporto di oltre 100 lingue | ||
| Supporto per la romanizzazione | ||
| Supporto per la traslitterazione | ||
| Traduzione adattiva | ||
| Supporto degli endpoint multiregionali | ||
| Supporto dei Controlli di servizio VPC |
Per maggiori dettagli sull'API Cloud Translation - Advanced, consulta Funzionalità dell'API Cloud Translation - Advanced.
Prezzi
L'API Cloud Translation addebita il costo su base mensile in base al numero di caratteri che invii. Per saperne di più, consulta i prezzi.
Risorse e ulteriori approfondimenti
- Per iniziare a utilizzare l'API, configurala e poi prova la guida rapida.
- Confronta i modelli supportati
- Personalizza il modello NMT
- Personalizza l'LLM di traduzione
- Lingue supportate
- Formati supportati
- Esegui la traduzione adattiva
- Esegui la migrazione a Translation Advanced
- Per risposte a domande generali sull'API Cloud Translation, consulta la pagina Domande frequenti di carattere generale.