Cotas e limites

O Cloud Translation impõe cotas sobre o tamanho do conteúdo de solicitações e o número de solicitações que você pode enviar. As cotas protegem a comunidade de usuários do Google Cloud, impedindo picos de uso imprevistos. Também é possível reduzir suas cotas para impedir o uso excessivo e os custos de controle.

Se você exceder sua cota, a API Cloud Translation retornará o erro 403. A mensagem de erro será Daily Limit Exceeded se você exceder o limite diário de cotas ou User Rate Limit Exceeded se as cotas por minuto forem excedidas.

As cotas diárias são redefinidas à meia-noite (horário do Pacífico). Isso significa que novas cotas podem levar até 24 horas para entrar em vigor.

Definir cotas de uso

Por padrão, o número de caracteres que você pode enviar por dia é ilimitado. Se você tiver um orçamento definido, recomendamos monitorar seu uso diário e ajustar cotas de acordo com seu gasto planejado.

É possível editar suas cotas na página de cotas do Console do Google Cloud. As v2 cotas se aplicam ao Cloud Translation - Basic e v3 se aplicam ao Cloud Translation - Advanced.

Cotas de conteúdo

As cotas de conteúdo se aplicam a strings de texto e documentos enviados à API Cloud Translation por meio dos métodos translateText, detectLanguage e translateDocument (solicitações síncronas). Todos os caracteres enviados à API Cloud Translation são considerados na contagem dessas cotas, incluindo os espaços em branco. Essas cotas são cumulativas se você usar o Cloud Translation - Basic e o Advanced Advanced.

Cota de conteúdo Padrão
Caracteres do modelo geral v2 e v3 por dia e projeto ilimitado
Caracteres do modelo geral v2 e v3 por minuto e projeto 6.000.000 de caracteres
Caracteres do modelo geral v2 e v3 por minuto, projeto e usuário* 6.000.000 de caracteres
Páginas de tradução de documentos v3 por minuto por projeto† 2.400 páginas
Páginas de tradução de documentos v3 por minuto por projeto por usuário† 2.400 páginas

* Cotas por usuário se aplicam ao número de solicitações que um usuário final, que esteja usando um aplicativo cliente, pode fazer por minuto. Ao usar uma conta de serviço, para fins de cota, a identidade dessa conta é o usuário. Se você usar a versão Basic do Cloud Translation e uma chave de API, o Cloud Translation usará o endereço IP do cliente para impor esse limite.

† A cota da página de tradução de documentos é contabilizada em relação à cota de caracteres do Cloud Translation. Por exemplo, se você enviar até 2.400 páginas por minuto, o número de caracteres nos documentos também não poderá exceder 6.000.000 caracteres. Para arquivos XLSX, somente as cotas de caracteres são aplicadas (não as cotas de páginas). O Cloud Translation não é compatível com o Cloud Translation - Basic.

A API Cloud Translation é otimizada para traduzir solicitações menores. O tamanho máximo recomendado de cada solicitação é de 5 mil caracteres (pontos de código). No entanto, quanto mais você incluir, maior será a latência de resposta. Para a Cloud Translation - Advanced, o número máximo de pontos de código para uma única solicitação é de 30.000. O tamanho máximo para solicitações da Cloud Translation - Basic é de 100.000 bytes. Uma alternativa é usar traduções em lote para enviar mais conteúdo por solicitação como uma operação de longa duração.

A API Cloud Translation rejeitará solicitações maiores que o limite e enviará um erro 400 INVALID_ARGUMENT, independentemente da cota disponível.

Solicitações de cotas

O Cloud Translation aplica uma cota sobre o número de solicitações que você envia ao serviço.

Cota Padrão
Solicitações para receber os idiomas compatíveis (v2 e v3 combinadas) por minuto por projeto 600 solicitações
Solicitações v3 por minuto e projeto† 6.000 solicitações
Solicitações v3 por minuto por projeto por usuário*† ilimitado
Número total de solicitações de tradução em lote v3 (texto e documentos) por dia por projeto ilimitado

* Cotas por usuário se aplicam ao número de solicitações que um usuário final, que esteja usando um aplicativo cliente, pode fazer por minuto. Ao usar uma conta de serviço, para fins de cota, a identidade dessa conta é o usuário. Se você usar a versão Basic do Cloud Translation e uma chave de API, o Cloud Translation usará o endereço IP do cliente para impor esse limite.

† Aplica-se a todas as chamadas do método Cloud Translation - Advanced, exceto para os métodos translateText, detectLanguage, translateDocument e getSupportedLanguages.

Cotas de AutoML

Para a versão Advanced do Cloud Translation, é possível usar modelos do AutoML para traduzir conteúdos. Quando você usa um modelo personalizado, o uso é contado a partir de um conjunto separado de cotas. Para mais informações sobre as cotas de conteúdo e solicitações de cotas do AutoML, consulte a documentação do AutoML Translation.

Como contar cotas

Na versão Basic do Cloud Translation, as cotas de conteúdo e as solicitações de cotas são contadas segundo o projeto que está fazendo a solicitação, que é determinado pela chave usada nela.

Na versão Advanced do Cloud Translation, a cota de conteúdo é verificada segundo o projeto que está associado ao modelo da solicitação. As solicitações de cotas são verificadas segundo o projeto que está fazendo a solicitação.

Por exemplo, na solicitação de tradução de texto a seguir, as cotas de solicitação são comparadas com project-id-1 porque a solicitação é proveniente de project-id-1. A cota de conteúdo é verificada com project-id-2, porque a solicitação está usando um modelo que está naquele projeto.

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."]
}

Limites do Cloud Translation - Advanced

A tabela a seguir descreve os limites da versão Advanced do Cloud Translation, que não pode ser alterado.

Descrição Limite
Número máximo de arquivos que você inclui em uma única solicitação em lote 100 arquivos
Número máximo de recursos de glossário para um projeto 1.000