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 diGoogle 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 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 Google Cloud pagina delle quote della 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 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 richieste.

Per le quote per i contenuti vengono conteggiati tutti i caratteri inviati all'API Cloud Translation, compresi gli spazi. Se utilizzi Cloud Translation - Basic e Cloud Translation - Advanced insieme, le quote sono cumulative.

Per le traduzioni di testo, le quote dei modelli personalizzati vengono conteggiate separatamente e non vengono conteggiate rispetto alle quote dei modelli generali. Tuttavia, esiste un limite al numero di modelli personalizzati richiesti in un solo giorno da un progetto. Inoltre, se viene utilizzato il modello translation-llm, non è prevista una quota di contenuti.

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.

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'alternativa è utilizzare le traduzioni 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 Cloud Translation, ad eccezione dei metodi translateDocument e getSupportedLanguages, che hanno quote di richieste o di contenuti proprie.

Le quote per i modelli personalizzati e translation-llm vengono conteggiate separatamente e non vengono conteggiate rispetto alle altre quote per le richieste v3.

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.

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.

LLM di traduzione

Traduzione adattiva