Cloud Translation applica le quote alle dimensioni del contenuto delle richieste e al numero di richieste che è possibile inviare. Le quote proteggono la community degli utenti di Google Cloud da picchi di utilizzo imprevisti. Puoi anche ridurre le quote per impedire l'utilizzo eccessivo e controllare i costi.
Se superi la quota, Cloud Translation restituisce l'errore 403.
Il messaggio di errore indica Daily Limit Exceeded se superi
una quota giornaliera o User Rate Limit Exceeded se superi una
quota per minuto.
I limiti giornalieri della quota si reimpostano alla mezzanotte del fuso orario del Pacifico, perciò potrebbero passare fino a 24 ore prima che i nuovi limiti entrino in vigore.
Impostare le quote di utilizzo
Per impostazione predefinita, il numero di caratteri che puoi inviare al giorno è illimitato. Se hai un budget prestabilito, ti consigliamo di monitorare l'utilizzo giornaliero e di modificare le quote in base alla spesa pianificata.
Puoi modificare le quote utilizzando la pagina delle quote della console Google Cloud. Le quote v2 si applicano a Cloud Translation - Basic e le quote v3 si applicano a Cloud Translation - Advanced.
Quote per i contenuti
Le quote per i contenuti si applicano alle richieste sincrone per i metodi translateText,
detectLanguage e translateDocument. Per le richieste asincrone, come le traduzioni di testo batch, vengono applicate solo le quote di richiesta.
Per le quote per i contenuti vengono conteggiati tutti i caratteri inviati all'API Cloud Translation, inclusi gli spazi. Se utilizzi Cloud Translation - Basic e Cloud Translation - Advanced insieme, queste quote sono cumulative.
Per le traduzioni di testo, le quote dei modelli personalizzati vengono conteggiate separatamente e non rientrano nelle quote dei modelli generali. Tuttavia, esiste un limite al numero di modelli personalizzati richiesti in un solo giorno da un progetto.
| Quota | Predefinito |
|---|---|
| Caratteri inviati al modello generale per progetto al giorno (v2 e v3) | Nessun limite |
| Caratteri inviati al modello generale per progetto al minuto (v2 e v3) | 6.000.000 |
| Caratteri inviati al modello generale per progetto, per minuto e per utente (v2 e v3) | 6.000.000 |
| Caratteri inviati per la traslitterazione al minuto per progetto (v3) | 100.000 (vengono conteggiati anche ai fini della quota di caratteri inviati al modello generale per progetto e per minuto) |
| Caratteri inviati per la romanizzazione per progetto al minuto (v3) | 100.000 |
| Caratteri inviati ai modelli personalizzati per progetto al minuto (v3) | 100.000 |
| Caratteri inviati ai modelli personalizzati per progetto, per minuto e per utente (v3) | fino al limite del progetto |
| Numero di modelli personalizzati univoci chiamati per progetto al giorno (v3) | 30 |
| Per la traduzione di documenti, pagine inviate per progetto al minuto (v3) | 2400 |
| Per la traduzione di documenti, pagine inviate per progetto al minuto per utente (v3) | 2400 |
Le quote per utente si applicano al numero di richieste che un utente finale che utilizza un'applicazione client può effettuare al minuto. Quando utilizzi un account di servizio, ai fini della quota l'identità dell'account di servizio è l'utente. Se utilizzi Cloud Translation - Basic e una chiave API, Cloud Translation utilizza l'indirizzo IP del client per applicare questo limite.
Limite di contenuti per richiesta
L'API Cloud Translation è ottimizzata per la traduzione di piccole richieste. La lunghezza massima consigliata per ogni richiesta è 5000 caratteri (punti di codice). Tuttavia, maggiore è il numero di caratteri inclusi, più alta è la latenza di risposta. Per Cloud Translation - Advanced, il numero massimo di punti di codice per una singola richiesta è 30.000. Cloud Translation - Basic ha una dimensione massima della richiesta di 100.000 byte. Un'opzione alternativa è utilizzare le traduzioni collettive per inviare più contenuti per richiesta come operazione a lungo termine.
L'API Cloud Translation rifiuta le richieste con dimensioni superiori al massimo e restituisce un errore 400 INVALID_ARGUMENT indipendentemente dalla quota disponibile.
Quote per le richieste
Cloud Translation applica una quota al numero di richieste che puoi inviare
al servizio. Queste quote si applicano a tutte le chiamate ai metodi Cloud Translation,
ad eccezione dei metodi translateDocument e getSupportedLanguages, che
hanno quote per richieste o contenuti proprie.
Le quote dei modelli personalizzati vengono conteggiate separatamente e non vengono considerate ai fini delle altre quote per le richieste v3.
| Quota | Predefinito |
|---|---|
| Richieste di lingue supportate (v2 e v3 combinate) per progetto al minuto | 600 |
| Richieste v2 al minuto per progetto | 300.000 |
| Richieste v2 per progetto al minuto per utente | fino al limite di progetti della versione 2 |
| Richieste v3 al minuto per progetto | 6000 |
| Richieste di romanizzazione v3 al minuto per progetto | 6000 |
| Richieste v3 al minuto per progetto per utente | fino al limite di progetti v3 |
| Richieste di traduzione batch v3 (testo e documenti) per progetto al giorno | Nessun limite |
| Richieste di traduzione con modello personalizzato v3 per progetto al giorno | Nessun limite |
| Richieste di traduzione del modello personalizzato v3 per progetto al minuto | 600 |
| Richieste di traduzione batch con modelli personalizzati v3 per progetto al giorno | Nessun limite |
| Richieste di creazione di modelli v3 al minuto per progetto | 10 |
| Richieste di creazione di modelli in parallelo v3 per progetto | 2 |
Le quote per utente si applicano al numero di richieste che un utente finale che utilizza un'applicazione client può effettuare al minuto. Quando utilizzi un account di servizio, ai fini della quota l'identità dell'account di servizio è l'utente. Se utilizzi Cloud Translation - Basic e una chiave API, Cloud Translation utilizza l'indirizzo IP del client per applicare questo limite.
Conteggio delle quote
Per Cloud Translation - Basic, le quote per i contenuti e le richieste sono conteggiate in base al progetto che effettua la richiesta, determinato dalla chiave utilizzata nella richiesta.
Per Cloud Translation - Advanced, la quota per il contenuto viene verificata in base al progetto associato al modello nella richiesta. Le quote per le richieste vengono verificate in base al progetto che effettua la richiesta.
Ad esempio, nella seguente richiesta di traduzione testo, le quote per le richieste
vengono verificate in base a project-id-1, perché la richiesta proviene da
project-id-1. La quota per il contenuto viene verificata in base a project-id-2, perché
la richiesta utilizza un modello in tale progetto.
POST https://translation.googleapis.com/v3/projects/project-id-1/locations/us-central1:translateText { "Model":"projects/project-id-2/locations/us-central1/models/model-id", "sourceLanguageCode": "en", "targetLanguageCode": "ru", "contents": ["Dr. Watson, please discard your trash."] }
Limiti per Cloud Translation - Advanced
Nella tabella che segue sono riportati i limiti per Cloud Translation - Advanced, che non possono essere modificati.
| Descrizione | Limite |
|---|---|
| Numero massimo di file che è possibile includere in una singola richiesta batch | 100 file |
| Numero massimo di risorse di glossario per un progetto | 10.000 |
Traduzione adattiva
| Descrizione | Limite |
|---|---|
| Numero massimo di coppie di segmenti che puoi importare | 10.000 (console Google Cloud) 30.000 (API) |
| Numero massimo di caratteri che puoi inviare per richiesta | 3000 |
| Numero massimo di caratteri di output della traduzione adattiva per richiesta | 3000 per le lingue (qualsiasi testo che supera questo limite viene eliminato) |