Quote e limiti

Questo documento elenca le quotas e i quotas che si applicano a Cloud Vision. Per ulteriori informazioni sulle quote, consulta Quote di Virtual Private Cloud.

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

  • Monitora l'utilizzo o il consumo dei prodotti e dei servizi Google Cloud.
  • Limita il consumo di queste risorse, per motivi che includono la garanzia di equità e la riduzione dei picchi di utilizzo.
  • Mantiene le configurazioni che applicano automaticamente le limitazioni prescritte.
  • Consente di 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 non riesce. Nella maggior parte dei casi, le quote vengono applicate a ogni progetto Google Cloud e vengono 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 superiore.

Esistono anche limiti per le risorse Vision. Questi limiti non sono correlati al sistema delle quote. Se non diversamente indicato, i limiti non possono essere modificati.

Tipi di quota

Esistono tre 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 nome della funzionalità come prefisso è in genere una quota di funzionalità.
  3. Quota in fase di elaborazione
    • Se non diversamente specificato, la quota viene conteggiata per immagine / file elaborato dall'API Vision.
    • 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 più di questa quota nei metodi asincroni, ma le immagini/pagine che superano la quota non vengono elaborate immediatamente. I file che superano la 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 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 nella 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).