Quote e limiti

Questo documento elenca le quote e i limiti di sistema che si applicano a Cloud Vision.

  • Le quote specificano la quantità di una risorsa condivisa e conteggiabile che puoi utilizzare. Le quote sono definite dai servizi Google Cloud come Cloud Vision.
  • I limiti di sistema sono valori fissi che non possono essere modificati.

Google Cloud utilizza le quote per contribuire a garantire l'equità e ridurre gli picchi di utilizzo e disponibilità delle risorse. Una quota limita la quantità di una risorsa Google Cloud che può essere utilizzata nel progetto Google Cloud. Le quote si applicano a una serie di tipi di risorse, inclusi hardware, software e componenti di rete. Ad esempio, le quote possono limitare il numero di chiamate API a un servizio, il numero di bilanciatori del carico utilizzati contemporaneamente dal tuo progetto o il numero di progetti che puoi creare. Le quote proteggono la community degli utenti di Google Cloud impedendo il sovraccarico dei servizi. Le quote ti aiutano anche a gestire le tue risorse Google Cloud.

Il sistema delle quote di Cloud esegue le seguenti operazioni:

  • Monitora il tuo consumo di prodotti e servizi Google Cloud
  • Limita il consumo di queste risorse
  • Fornisce un modo per richiedere modifiche al valore della quota

Nella maggior parte dei casi, quando provi a utilizzare una risorsa per un volume maggiore di quello consentito dalla quota, il sistema blocca l'accesso alla risorsa e l'attività che stai tentando di eseguire non va a buon fine.

In genere, le quote si applicano a livello di progetto Google Cloud. L'utilizzo di una risorsa in un progetto non influisce sulla quota disponibile in un altro progetto. All'interno di un progetto Google Cloud, le quote sono condivise tra tutte le applicazioni e gli indirizzi IP.

Per modificare la maggior parte delle quote, utilizza la console Google Cloud. Per ulteriori informazioni, consulta Richiedere un aggiustamento della quota.

Esistono anche limiti di sistema per le risorse di Vision. I limiti di sistema non possono essere modificati.

Tipi di quote

Esistono tre tipi di quote:

  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 esplicitamente specificato, la quota con il nome della funzionalità come prefisso è generalmente una quota per le funzionalità.
  3. Quota in fase di elaborazione
    • La quota viene calcolata in base al numero di immagini / file in fase di elaborazione da parte dell'API Vision, se non esplicitamente specificato.
    • Può essere dedotta dalla dicitura "in fase di elaborazione" nel nome della quota.
    • Questa quota determina il numero massimo di immagini/pagine elaborate contemporaneamente dall'API Vision per i metodi asincroni. Gli utenti possono inviare più di questa quota nei metodi asincroni, ma le immagini/pagine che superano la quota non vengono elaborate immediatamente. I file in eccesso rispetto alla quota vengono aggiunti a una coda per essere elaborati 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 di 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
* Richieste images:asyncBatchAnnotate
† Richieste files:asyncBatchAnnotate, funzionalità DOCUMENT_TEXT_DETECTION
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 nella console di 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 a portarle al loro valore massimo selezionando MODIFICA QUOTE nella pagina Quote della pagina di Google Cloud Console. 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 del 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).