Kontingente und Limits

In diesem Dokument sind die Kontingente und Limits für Cloud Vision aufgeführt.

  • Kontingente geben an, wie viel einer zählbaren, freigegebenen Ressource Sie verwenden können. Kontingente werden von Google Cloud-Diensten wie Cloud Vision definiert.
  • Systemlimits sind feste Werte, die nicht geändert werden können.

Google Cloud nutzt Kontingente, um Fairness zu gewährleisten und Spitzen bei Ressourcennutzung und -verfügbarkeit zu reduzieren. Ein Kontingent schränkt ein, wie viel von einer Google Cloud-Ressource Ihr Google Cloud-Projekt nutzen darf. Kontingente gelten für eine Reihe von Ressourcentypen, einschließlich Hardware, Software und Netzwerkkomponenten. Mit Kontingenten können Sie beispielsweise die Anzahl der API-Aufrufe an einen Dienst, die Anzahl der von Ihrem Projekt gleichzeitig verwendeten Load Balancer oder die Anzahl der Projekte begrenzen, die Sie erstellen können. Die Kontingente sollen eine Überlastung von Diensten verhindern und dadurch die Community der Google Cloud-Nutzer schützen. Sie helfen Ihnen auch bei der Verwaltung Ihrer eigenen Google Cloud-Ressourcen.

Das Cloud-Kontingentsystem ermöglicht Folgendes:

  • Ihren Verbrauch von Google Cloud-Produkten und -Diensten überwachen
  • Ihren Verbrauch dieser Ressourcen einschränken
  • Eine Möglichkeit bieten, Änderungen am Kontingentwert anzufordern

Wenn Sie versuchen, mehr von einer Ressource zu verbrauchen, als das Kontingent zulässt, blockiert das System in den meisten Fällen den Zugriff auf die Ressource. Die Aufgabe, die Sie ausführen möchten, schlägt fehl.

Kontingente gelten in der Regel auf Google Cloud-Projektebene. Ihre Nutzung einer Ressource in einem Projekt hat keinen Einfluss auf Ihr verfügbares Kontingent in einem anderen Projekt. Innerhalb eines Google Cloud-Projekts werden die Kontingente für alle Anwendungen und IP-Adressen gemeinsam genutzt.

Verwenden Sie die Google Cloud Console, um die meisten Kontingente anzupassen. Weitere Informationen finden Sie unter Kontingentanpassung beantragen.

Für Vision-Ressourcen gelten außerdem Limits. Systemlimits können nicht geändert werden.

Kontingenttypen

Es gibt drei Arten von Kontingenten:

  1. Anfragekontingent
    • Das Kontingent zählt pro Anfrage, die an den Vision API-Endpunkt gesendet wird.
  2. Feature-Kontingent
    • Das Kontingent zählt pro Bild/Datei, die an den Vision API-Endpunkt gesendet wird.
    • Sofern nicht ausdrücklich angegeben, ist ein Kontingent mit Featurename als Präfix im Allgemeinen ein Feature-Kontingent.
  3. Kontingent „in Verarbeitung“
    • Sofern nicht ausdrücklich anders angegeben, zählt das Kontingent pro Bild/Datei, die von der Vision API verarbeitet wird.
    • Kann von „in Verarbeitung“ im Kontingentnamen abgeleitet werden.
    • Dieses Kontingent bestimmt die maximale Anzahl von Bildern/Seiten, die die Vision API gleichzeitig für die asynchronen Methoden verarbeitet. Nutzer können mehr als dieses Kontingent an die asynchronen Methoden senden, aber die Bilder/Seiten über dem Kontingent werden nicht sofort verarbeitet. Die Dateien, die das Kontingent überschreiten, werden einer Warteschlange hinzugefügt, um sie später zu verarbeiten.

Aktuelle API-Nutzungskontingente für die Vision API (Änderungen vorbehalten):

Vision API-Kontingent Kontingenttyp Wert
Anfragen pro Minute (außer nachfolgende Anfragetypen) Anfragekontingent 1.800
Anfragen an die Prominentenerkennung pro Minute Anfragekontingent Null
Labelerkennungsanfragen pro Minute Feature-Kontingent 1.800
Texterkennungsanfragen pro Minute Feature-Kontingent 1.800
Asynchrone Bildannotation* – Anzahl der Bilder in Verarbeitung Kontingent „in Verarbeitung“ 8.000
Asynchrone Erkennung von Dokumenttext† – Anzahl der Seiten in Verarbeitung Kontingent „in Verarbeitung“ 10.000
* images:asyncBatchAnnotate-Anfragen
† files:asyncBatchAnnotate-Anfragen, DOCUMENT_TEXT_DETECTION-Feature
Kontingente für die Produktsuche Wert
Anfragen pro Minute (außer nachfolgende Anfragetypen) 1.800
Batchanfragen pro Tag 300
Schreibanfragen für Ressourcenverwaltung pro Minute 1.200
Anfragen für Ressourcenverwaltung pro Minute 2.400

Die Limits gelten für alle Google Cloud Console-Projekte sowie für alle Anwendungen und IP-Adressen, die dieses Projekt verwenden.

Niedrigere Kontingente können in der Google Cloud Console festgelegt werden.

Kontingent erhöhen

Sie können die Kontingente auf die jeweiligen Maximalwerte erhöhen. Klicken Sie dazu in der Google Cloud Console auf der Seite Kontingente auf KONTINGENTE BEARBEITEN. Wenn Sie eine Erhöhung über das maximale Kontingent hinaus möchten, geben Sie für Ihr Kontingent die gewünschte Erhöhung und eine Begründung an und reichen Sie diese Aktualisierung ein. Sie werden benachrichtigt, sobald Ihr Antrag eingegangen ist. Möglicherweise werden Sie um weitere Informationen zu Ihrem Antrag gebeten. Nach Prüfung des Antrags wird Ihnen mitgeteilt, ob er genehmigt oder abgelehnt wurde.

In der Regel gelten für jedes Kontingent die Varianten „pro Projekt und Nutzer“ und „pro Projekt“. Ändern Sie diese Einstellungen jeweils entsprechend Ihrer Einrichtung.

Wenn Sie eine Erhöhung des Feature-Kontingents beantragen, sollten Sie das Gesamtanfragekontingent und die gewünschte Batchgröße berücksichtigen, um Folgendes zu gewährleisten:

  • Gesamtanfragekontingent (Anfragen pro Minute) * Ihre Batchgröße >= erhöhtes Feature-Kontingent

Wenn Sie diese Anforderung nicht erfüllen, wird Ihr Gesamtanfragekontingent gedrosselt.

In diesem Dokument werden die aktuellen Inhaltslimits und Anfragekontingente für die Vision API beschrieben. Bei Änderungen der Beschränkungen und Nutzungslimits wird die Seite entsprechend aktualisiert.

Limits

Die Vision API unterliegt folgenden Nutzungslimits:

Limit für Inhalte Wert
Größe der Bilddatei 20 MB
Größe des JSON-Anfrageobjekts 10 MB
Größe der PDF-Datei 1 GB
Bilder pro images:annotate-Anfrage 16
Bilder pro images:asyncBatchAnnotate-Anfrage 2000
Seiten pro files:annotate-Anfrage 5
Seiten pro files:asyncBatchAnnotate-Anfrage 2000

Base64-codierte Bilder überschreiten möglicherweise das JSON-Größenlimit, auch wenn sie innerhalb des Limits für die Bilddateigröße liegen. Größere Bilder sollten auf Cloud Storage oder unter einer öffentlich zugänglichen URL gehostet werden. Die Dateigröße von base64-codierten Bildern kann die der ursprünglichen Bilddatei überschreiten (meist um etwa 37 %).