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.
Imposta le quote di utilizzo
Per impostazione predefinita, il numero di caratteri che puoi inviare al giorno è illimitato. Se hai un budget fisso, 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, si applicano solo le quote di richiesta.
Tutti i caratteri che invii all'API Cloud Translation vengono conteggiati ai fini delle quote per i contenuti, inclusi gli spazi. Se utilizzi Cloud Translation - Basic e Cloud Translation - Advanced, le quote sono cumulative.
Per le traduzioni del testo, le quote dei modelli personalizzati vengono conteggiate separatamente e non vengono conteggiate nelle quote generali del modello.
| 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 a modello generale per progetto al minuto per utente (v2 e v3) | 6.000.000 |
| Caratteri inviati per la traslitterazione per progetto al minuto (v3) | 100.000 (conta anche per i caratteri inviati al modello generale per quota di progetto al minuto) |
| Caratteri inviati per la romanizzazione per progetto al minuto (v3) | 100.000 |
| Caratteri inviati a modelli personalizzati per progetto al minuto (v3) | 100.000 |
| Caratteri inviati a modelli personalizzati per progetto al minuto per utente (v3) | fino al limite del progetto |
| Per la traduzione del documento, le pagine inviate per progetto al minuto (v3) | 2400 |
| Per la traduzione del documento, le 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 usi 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 richieste più piccole. 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 è l'utilizzo di traduzioni in batch per inviare più contenuti per richiesta come operazione a lunga esecuzione.
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 di Cloud Translation, ad eccezione dei metodi translateDocument e getSupportedLanguages, che hanno le proprie quote di richieste o contenuti.
Le quote dei modelli personalizzati vengono conteggiate separatamente e non vengono conteggiate nelle altre quote per le richieste v3.
| Quota | Predefinito |
|---|---|
| Richieste per ottenere le lingue supportate (v2 e v3 combinate) per progetto al minuto | 600 |
| Richieste v2 per progetto al minuto | 300.000 |
| Richieste v2 per progetto al minuto per utente | fino al limite del progetto v2 |
| Richieste v3 per progetto al minuto | 6000 |
| Richieste di traslitterazione in versione 3 per progetto al minuto | 6000 |
| Richieste v3 per progetto al minuto per utente | fino al limite del progetto v3 |
| Richieste di traduzione batch v3 (testo e documenti) per progetto al giorno | Nessun limite |
| Richieste di traduzione di modelli personalizzati v3 per progetto al giorno | Nessun limite |
| Richieste di traduzione di modelli personalizzati v3 per progetto al minuto | 600 |
| Richieste di traduzione batch modello personalizzato v3 per progetto al giorno | Nessun limite |
| Richieste di creazione di modelli v3 per progetto al minuto | 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 usi 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 |