Quote e limiti

Questo documento elenca le quotas e i quotas che si applicano a Cloud Vision.

Una quota limita la quantità di una risorsa Google Cloud condivisa che può essere utilizzata dal progetto Google Cloud, inclusi hardware, software e componenti di rete. Pertanto, le quote fanno parte di un sistema che:

  • Monitora il tuo utilizzo o consumo di prodotti e servizi Google Cloud.
  • Limita il consumo di queste risorse, per motivi che includono la garanzia dell'equità e la riduzione dei picchi di utilizzo.
  • Mantiene configurazioni che applicano automaticamente le limitazioni prescritte.
  • Offre un mezzo per richiedere o modificare la quota.

Nella maggior parte dei casi, quando viene superata una quota, il sistema blocca immediatamente l'accesso alla risorsa Google pertinente e l'attività che stai tentando di eseguire ha esito negativo. Nella maggior parte dei casi, le quote si applicano a ogni progetto Google Cloud e sono condivise tra tutte le applicazioni e gli indirizzi IP che utilizzano il progetto Google Cloud.

Per aumentare o diminuire la maggior parte delle quote, utilizza la console Google Cloud. Per ulteriori informazioni, consulta Richiedere una quota più alta.

Esistono anche dei limiti per le risorse Vision. Questi limiti non sono correlati al sistema di quote. I limiti non possono essere modificati se non diversamente indicato.

Tipi di quota

Esistono 3 tipi di quota:

  1. Quota per le richieste
    • La quota viene calcolata in base al numero di richieste inviate all'endpoint dell'API Vision.
  2. Quota per le funzionalità
    • La quota viene calcolata in base al numero di immagini/file inviati all'endpoint dell'API Vision.
    • Se non diversamente specificato, la quota con il nome della funzionalità come prefisso è in genere una quota delle funzionalità.
  3. Quota in fase di elaborazione
    • La quota viene conteggiata per immagine / file elaborato dall'API Vision, se non specificato esplicitamente.
    • Può essere dedotta dalla dicitura "in fase di elaborazione" nel nome della quota.
    • Questa quota determina il numero massimo di immagini/pagine che l'API Vision elabora contemporaneamente per i metodi asincroni. Gli utenti possono inviare un numero maggiore di questa quota ai metodi asincroni, ma le immagini e le pagine che superano la quota non vengono elaborate immediatamente. I file in eccesso rispetto alla quota vengono aggiunti a una coda per essere elaborata in un secondo momento.

Di seguito sono riportate le quote di utilizzo attuali dell'API Vision (soggette a modifica):

Quota dell'API Vision Tipo di quota Valore
Richieste al minuto (eccetto per i tipi di richiesta elencati di seguito) Quota per le richieste 1800
Richieste di riconoscimento di volti celebri al minuto Quota per le richieste zero
Richieste di rilevamento etichette al minuto Quota per le funzionalità 1800
Richieste di rilevamento testo al minuto Quota per le funzionalità 1800
Annotazione asincrona delle immagini* (numero di immagini in elaborazione) Quota in fase di elaborazione 8000
Rilevamento asincrono di testo nei documenti (numero di pagine in elaborazione) Quota in fase di elaborazione 10.000
Quota per Product Search Valore
Richieste al minuto (eccetto per i tipi di richiesta elencati di seguito) 1800
Richieste batch al giorno 300
Richieste di scrittura per la gestione delle risorse al minuto 1200
Richieste per la gestione delle risorse al minuto 2400

Questi limiti si applicano a ogni progetto della console Google Cloud e sono condivisi tra tutte le applicazioni e gli indirizzi IP che utilizzano il progetto.

È possibile impostare quote inferiori per utente nella console Google Cloud.

Aumenti di quota

Puoi modificare le quote fino al loro valore massimo selezionando MODIFICA QUOTE dalla pagina Quote della pagina della console Google Cloud. Per richiedere un aumento superiore alla quota massima, modifica la quota con l'aumento richiesto e la giustificazione e invia il tuo aggiornamento. Riceverai una notifica quando la richiesta sarà ricevuta. È possibile che ti vengano chieste ulteriori informazioni in merito alla tua richiesta. Dopo che la richiesta è stata esaminata, riceverai una notifica per informarti se è stata approvata o respinta.

In genere, ogni quota ha varianti "per progetto per utente" e "per progetto"; modificale in base alla configurazione.

Quando richiedi un aumento della quota per le funzionalità, considera la quota per le richieste complessiva e la dimensione del batch prevista per assicurarti che venga soddisfatta la seguente condizione:

  • quota per le richieste complessiva (richieste al minuto) * dimensione del batch >= quota per le funzionalità aumentata

Se non soddisfi questo requisito, continuerai comunque a essere limitato dalla quota per le richieste complessiva.

Questo documento contiene i limiti per i contenuti e le quote per le richieste attuali per l'API Vision. Questa pagina sarà aggiornata per riflettere eventuali modifiche a tali restrizioni e limiti di utilizzo.

Limiti

L'API Vision applica i seguenti limiti di utilizzo:

Limite per contenuto Valore
Dimensione file immagine 20 MB
Dimensione oggetto richiesta JSON 10 MB
Dimensioni file PDF 1 GB
Immagini per richiesta di images:annotate 16
Immagini per richiesta di images:asyncBatchAnnotate 2000
Pagine per richiesta files:annotate 5
Pagine per richiesta files:asyncBatchAnnotate 2000

Le immagini con codifica Base64 possono superare il limite della dimensione JSON, anche se si trovano entro il limite di dimensione del file immagine. Le immagini più grandi dovrebbero essere ospitate su Cloud Storage o su un URL accessibile pubblicamente. Tieni presente che le immagini con codifica base64 possono avere una dimensione file maggiore rispetto al file immagine originale (in genere superiore del 37% circa).