Quotas e limites

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

  • As quotas especificam a quantidade de um recurso partilhado contabilizável que pode usar. As quotas são definidas por Google Cloud serviços como o Cloud Vision.
  • Os limites do sistema são valores fixos que não podem ser alterados.

Google Cloud usa quotas para ajudar a garantir a equidade e reduzir os picos na utilização e disponibilidade de recursos. Uma quota restringe a quantidade de um Google Cloud recurso que o seu Google Cloud projeto pode usar. As quotas aplicam-se a uma variedade de tipos de recursos, incluindo componentes de hardware, software e rede. Por exemplo, as quotas podem restringir o número de chamadas API para um serviço, o número de balanceadores de carga usados em simultâneo pelo seu projeto ou o número de projetos que pode criar. As quotas protegem a comunidade de Google Cloud utilizadores, impedindo a sobrecarga dos serviços. As quotas também ajudam a gerir os seus próprios Google Cloud recursos.

O sistema de quotas da nuvem faz o seguinte:

Na maioria dos casos, quando tenta consumir mais de um recurso do que a respetiva quota permite, o sistema bloqueia o acesso ao recurso e a tarefa que está a tentar realizar falha.

Geralmente, as quotas aplicam-se ao nível do Google Cloud projeto A sua utilização de um recurso num projeto não afeta a sua quota disponível noutro projeto. Num Google Cloud projeto, as quotas são partilhadas por todas as aplicações e endereços IP.

Para ajustar a maioria das quotas, use a Google Cloud consola. Para mais informações, consulte o artigo Peça um ajuste da quota.

Também existem limites do sistema nos recursos do Vision. Não é possível alterar os limites do sistema.

Tipos de quotas

Existem 3 tipos de quota:

  1. Pedir quota
    • A quota é contabilizada por pedido enviado para o ponto final da API Vision.
  2. Quota de funcionalidades
    • A quota é contabilizada por imagem / página enviada para o ponto final da API Vision.
    • Salvo especificação explícita, a quota com o nome da funcionalidade como prefixo é, geralmente, uma quota de funcionalidades.
    • Para pedidos files:annotate, se o campo pages não for especificado explicitamente, a quota conta 5 páginas por ficheiro. No entanto, os utilizadores só recebem faturação pelo número real de páginas processadas.
  3. Dentro da quota de processamento
    • A quota é contabilizada por imagem / página processada pela API Vision, salvo especificação explícita.
    • Pode ser inferido por "in processing" no nome da quota.
    • Esta quota determina o número máximo de imagens/páginas que a API Vision processa de cada vez para os métodos assíncronos. Os utilizadores podem enviar mais do que esta quota para os métodos assíncronos, mas as imagens/páginas acima da quota não são processadas imediatamente. Os ficheiros que excedem a quota são adicionados a uma fila para serem processados mais tarde.

As quotas de utilização da API atuais para a API Vision são as seguintes (e estão sujeitas a alterações):

Quota da API Vision Tipo de quota Valor
Pedidos por minuto (exceto os tipos de pedidos indicados abaixo) Quota de pedidos 1800
Pedidos de reconhecimento de celebridades por minuto Quota de pedidos zero
Pedidos de deteção de etiquetas por minuto Quota de funcionalidades 1800
Pedidos de deteção de texto por minuto Quota de funcionalidades 1800
Anotação de imagens assíncrona* número de imagens em processamento Quota em processamento 8000
Deteção de texto em documentos assíncrona† número de páginas em processamento Quota em processamento 10 000
* images:asyncBatchAnnotate pedidos
† files:asyncBatchAnnotate pedidos, DOCUMENT_TEXT_DETECTION funcionalidade
Quota de pesquisa de produtos Valor
Pedidos por minuto (exceto os tipos de pedidos indicados abaixo) 1800
Pedidos em lote por dia 300
Pedidos de escrita de gestão de recursos por minuto 1200
Pedidos de gestão de recursos por minuto 2400

Estes limites aplicam-se a cada Google Cloud projeto da consola e são partilhados por todas as aplicações e endereços IP que usam esse projeto.

É possível definir quotas mais baixas por utilizador na Google Cloud consola.

Aumentos de quotas

Pode editar as suas quotas até aos respetivos valores máximos selecionando EDITAR QUOTAS na página Quotas da página da Google Cloud consola. Para pedir um aumento acima da quota máxima, edite a quota com o aumento e a justificação pedidos e envie a atualização. Recebe uma notificação quando o seu pedido for recebido. Podemos entrar em contacto consigo para obter mais informações acerca da sua solicitação. Após a revisão da sua solicitação, vai receber uma notificação a indicar se foi aprovada ou recusada.

Geralmente, cada quota tem variantes "por projeto por utilizador" e "por projeto". Altere-as em conformidade com a sua configuração.

Ao pedir um aumento da quota de funcionalidades, considere a quota de pedidos geral e o tamanho do lote pretendido para garantir o seguinte:

  • Quota de pedidos geral (pedidos por minuto) * tamanho do lote >= quota de funcionalidades aumentada

Se não cumprir este requisito, continua a estar sujeito à restrição da quota de pedidos geral.

Este documento contém os limites de conteúdo atuais e as quotas de pedidos para a API Vision. Esta página vai ser atualizada para refletir quaisquer alterações a estas restrições e limites de utilização.

Limites

A API Vision aplica os seguintes limites de utilização:

Limite de conteúdo Valor
Tamanho do ficheiro de imagem 20 MB
Tamanho do objeto de pedido JSON 10 MB
Tamanho do ficheiro PDF 1 GB
Imagens por pedido de images:annotate 16
Imagens por pedido de images:asyncBatchAnnotate 2000
Páginas por pedido de files:annotate 5
Páginas por pedido de 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 ficheiro de imagem. As imagens maiores devem ser alojadas no Cloud Storage ou num URL acessível publicamente. Tenha em atenção que as imagens codificadas em base64 podem ter um tamanho do ficheiro maior do que o ficheiro de imagem original (normalmente, cerca de 37% maior).