Cotas e limites

Este documento lista as cotas e os limites do sistema que se aplicam ao Cloud Vision.

  • As cotas especificam a quantidade de um recurso compartilhado e contável que pode ser usado. As cotas são definidas por serviços do Google Cloud, como o Cloud Vision.
  • Os limites do sistema são valores fixos que não podem ser alterados.

O Google Cloud usa cotas para garantir a imparcialidade e reduzir picos no uso e na disponibilidade de recursos. Uma cota restringe quanto de um recurso do Google Cloud o projeto do Google Cloud pode usar. As cotas se aplicam a vários tipos de recursos, incluindo hardware, software e componentes de rede. Por exemplo, as cotas podem restringir o número de chamadas de API para um serviço, o número de balanceadores de carga usados simultaneamente pelo projeto ou o número de projetos que podem ser criados. As cotas protegem a comunidade de usuários do Google Cloud, impedindo a sobrecarga de serviços. As cotas também ajudam você a gerenciar seus próprios recursos do Google Cloud.

O sistema de cotas do Cloud faz o seguinte:

  • Monitora o consumo de produtos e serviços do Google Cloud.
  • Restringe o consumo desses recursos.
  • Fornece um meio de solicitar mudanças no valor da cota

Na maioria dos casos, quando você tenta consumir mais de um recurso do que a cota permite, o sistema bloqueia o acesso ao recurso e a tarefa que você está tentando executar falha.

As cotas geralmente se aplicam ao projeto do nível Google Cloud. O uso de um recurso em um projeto não afeta a cota disponível em outro. Em um projeto do Google Cloud, as cotas são compartilhadas entre todos os aplicativos e endereços IP.

Para ajustar a maioria das cotas, use o console do Google Cloud. Para mais informações, consulte Solicitar um ajuste de cota.

Também há limites de sistemas nos recursos do Vision. Não é possível alterar os limites.

Tipos de cota

Há três tipos de cota:

  1. Cota de solicitação
    • A cota contabiliza as solicitações enviadas ao endpoint da API Vision.
  2. Cota de recurso
    • A cota contabiliza as imagens/os arquivos enviados para o endpoint da API Vision.
    • A menos que especificado explicitamente, a cota com o nome do recurso como prefixo será geralmente uma cota de recurso.
  3. Cota de processamento
    • A cota contabiliza as imagens/os arquivos que estão sendo processados pela API Vision, a menos que o contrário seja especificado explicitamente.
    • A cota pode ser identificada pelas palavras "em processamento" no nome da cota.
    • Essa cota determina o número máximo de imagens/páginas que a API Vision processa por vez para os métodos assíncronos. Os usuários podem enviar mais do que essa cota para os métodos assíncronos, mas as imagens/páginas acima da cota não são processadas imediatamente. Os arquivos que excedem a cota são adicionados a uma fila para serem processados posteriormente.

Estas são as cotas de uso atuais da API Vision (sujeitas a alterações):

Cota da API Vision Tipo de cota Valor
Solicitações por minuto (exceto os tipos listados abaixo) Solicitação de cotas 1.800
Solicitações de reconhecimento de celebridades por minuto Solicitação de cotas zero
Solicitações de detecção de rótulos por minuto Cota de recurso 1.800
Solicitações de detecção de texto por minuto Cota de recurso 1.800
Anotação de imagem assíncrona*: número de imagens em processamento Cota de processamento 8.000
Detecção de texto em documentos assíncrona: número de páginas em processamento Cota de processamento 10.000
Cota da Pesquisa de produtos Valor
Solicitações por minuto (exceto os tipos listados abaixo) 1.800
Solicitações em lote por dia 300
Solicitações de gravação de gerenciamento de recursos por minuto 1.200
Solicitações de gerenciamento de recursos por minuto 2.400

Esses limites se aplicam a cada projeto do Console do Google Cloud e são compartilhados em todos os aplicativos e endereços IP que usam o projeto.

Cotas menores podem ser definidas por usuário no Console do Google Cloud.

Aumento de cotas

Para editar as cotas até o valor máximo, selecione EDITAR COTAS na página Cotas do Console do Google Cloud. Para solicitar um aumento acima do limite, edite a cota com o aumento que você quer e informe o motivo. Em seguida, envie sua atualização. Você será notificado quando a solicitação for recebida. Talvez seja necessário entrar em contato com você para pedir mais informações. Depois que a solicitação for analisada, você será notificado se ela foi recusada ou aprovada.

Geralmente, cada cota tem variantes "por projeto por usuário" e "por projeto". É preciso alterá-las de acordo com sua configuração.

Ao solicitar um aumento de cota de recurso, considere a cota geral de solicitações e o tamanho pretendido do lote para garantir o seguinte:

  • Cota geral de solicitações (solicitações por minuto) * tamanho do lote >= cota de recurso aumentada

Se você não atender a esse requisito, você ainda será limitado pela cota geral de solicitações.

Este documento contém os limites de conteúdo e as cotas de solicitação atuais da API Vision. Esta página será atualizada para refletir mudanças com relação a esses limites e cotas.

Limites

A API Vision aplica os seguintes limites de uso:

Limite de conteúdo Valor
Tamanho do arquivo de imagem 20 MB
Tamanho do objeto da solicitação JSON 10 MB
Tamanho do arquivo PDF 1 GB
Imagens por solicitação images:annotate 16
Imagens por solicitação images:asyncBatchAnnotate 2000
Páginas por solicitação files:annotate 5
Páginas por solicitação files:asyncBatchAnnotate 2000

As imagens codificadas em base64 podem exceder o limite de tamanho do JSON, mesmo que estejam dentro do limite de tamanho do arquivo de imagem. Imagens maiores precisam ser hospedadas no Cloud Storage ou em um URL de acesso público. As imagens codificadas em base64 podem ter um tamanho de arquivo maior que o arquivo de imagem original. Geralmente elas são cerca de 37% maiores.