Quote e limiti

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 quote di utilizzo

Per impostazione predefinita, il numero di caratteri che puoi inviare al giorno è illimitato. Se hai un budget definito, ti consigliamo di monitorare l'utilizzo giornaliero e di modificare le quote in base alla tua spesa pianificata.

Puoi modificare le tue quote utilizzando la pagina delle quote di Google Cloud Console. 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 stringhe di testo e ai documenti che invii all'API Cloud Translation tramite i metodi translateText, detectLanguage e translateDocument (richieste sincrone). Tutti i caratteri inviati all'API Cloud Translation vengono conteggiati per il conteggio di queste quote, inclusi gli spazi. Queste quote sono cumulative se utilizzi Cloud Translation - Basic e Cloud Translation - Advanced.

Quota per i contenuti Valore predefinito
Caratteri del modello generale v2 e v3 al giorno per progetto illimitati
Caratteri del modello generale v2 e v3 al minuto per progetto 6.000.000 di caratteri
Caratteri del modello generale v2 e v3 al minuto per progetto per utente* 6.000.000 di caratteri
Pagine di traduzione di documenti v3 al minuto per progetto 2400 pagine
Pagine di traduzione di documenti v3 al minuto per progetto per utente 2400 pagine

* Le quote per utente limitano il 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.

Viene conteggiata la quota di pagina per la traduzione di documenti rispetto alla quota di caratteri per Cloud Translation. Ad esempio, se invii fino a 2400 pagine al minuto, il numero di caratteri nei documenti non può superare i 6.000.000. Per i file XLSX, si applicano solo le quote di caratteri (non le quote di pagina). La traduzione di documenti non è supportata per Cloud Translation - Basic.

L'API Cloud Translation è ottimizzata per la traduzione di richieste di dimensioni minori. La lunghezza massima consigliata per ogni richiesta è di 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 batch per inviare più contenuti per richiesta come un'operazione a lunga esecuzione.

L'API Cloud Translation rifiuta le richieste più grandi del massimo e restituisce un errore 400 INVALID_ARGUMENT a prescindere dalla quota disponibile.

Quote per le richieste

Cloud Translation applica una quota al numero di richieste che puoi inviare al servizio.

Quota Predefinito
Richieste di recupero delle lingue supportate (v2 e v3) al minuto per progetto 600 richieste
Richieste v2 al minuto per progetto 300.000 richieste
Richieste v2 al minuto per progetto per utente* fino al limite v2 per progetto
Richieste v3 al minuto per progetto 6000 richieste
Richieste v3 al minuto per progetto per utente* fino al limite di v3 per progetto
Numero totale di richieste di traduzione batch v3 (testo e documenti) al giorno per progetto Nessun limite

* Le quote per utente limitano il 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.

Si applica a tutte le chiamate ai metodi Cloud Translation ad eccezione dei metodi translateText, detectLanguage, translateDocument e getSupportedLanguages, che hanno le proprie quote per le richieste o i contenuti.

Quote AutoML

Per Cloud Translation - Advanced, puoi utilizzare i modelli di AutoML per tradurre i contenuti. Quando utilizzi un modello personalizzato, l'utilizzo viene conteggiato in base alle quote impostate separatamente. Per ulteriori informazioni sulle quote per le richieste e i contenuti AutoML, consulta la documentazione di AutoML Translation.

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