Kontingente und Limits

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

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

Google Cloud nutzt Kontingente, um Fairness zu gewährleisten und Spitzen bei der Ressourcennutzung und ‑verfügbarkeit zu reduzieren. Ein Kontingent schränkt ein, wie viel von einerGoogle 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 derGoogle Cloud -Nutzer schützen. Sie helfen auch bei der Verwaltung Ihrer eigenen Google Cloud -Ressourcen.

Das Cloud-Kontingentsystem tut Folgendes:

• Es überwacht Ihren Verbrauch von Google Cloud -Produkten und ‑Diensten.
• Es schränkt Ihren Verbrauch dieser Ressourcen ein.
• Es bietet eine Möglichkeit, Änderungen am Kontingentwert zu beantragen und Kontingentanpassungen zu automatisieren.

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 auszuführen versuchen, schlägt dann fehl.

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

Die meisten Kontingente können Sie in der Google Cloud Console anpassen. Weitere Informationen finden Sie unter Kontingentanpassung anfordern.

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

Kontingenttypen

Es gibt drei Arten von Kontingenten:

1. Anfragekontingent
   • Jede gesendete Anfrage an den Vision API-Endpunkt wird gegen das Kontingent gezählt.
2. Featurekontingent
   • Jedes gesendete Bild/jede gesendete Seite an den Vision API-Endpunkt wird gegen das Kontingent gezählt.
   • Sofern nicht ausdrücklich anders angegeben, ist ein Kontingent mit einem Featurenamen als Präfix im Allgemeinen ein Featurekontingent.
   • Bei files:annotate-Anfragen werden fünf Seiten pro Datei gegen das Kontingent gezählt, wenn das Feld pages nicht explizit angegeben ist. Nutzern wird jedoch nur die tatsächlich verarbeitete Anzahl von Seiten in Rechnung gestellt.
3. Verarbeitungskontingent
   • Sofern nicht ausdrücklich anders angegeben, wird jedes Bild/jede Seite, das bzw. die von der Vision API verarbeitet wird, gegen das Kontingent gezählt.
   • Wenn „Verarbeitung“ Teil des Kontingentnamens ist, handelt es sich um ein Verarbeitungskontingent.
   • Dieses Kontingent bestimmt die maximale Anzahl von Bildern/Seiten, die die Vision API mit asynchronen Methoden gleichzeitig 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 zur späteren Verarbeitung hinzugefügt.

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	0
Labelerkennungsanfragen pro Minute	Featurekontingent	1.800
Texterkennungsanfragen pro Minute	Featurekontingent	1.800
Asynchrone Bildannotation* – Anzahl der Bilder in Verarbeitung	Verarbeitungskontingent	8.000
Asynchrone Erkennung von Dokumenttext^† – Anzahl der Seiten in Verarbeitung	Verarbeitungskontingent	10.000

*	images:asyncBatchAnnotate-Anfragen
†	files:asyncBatchAnnotate-Anfragen, DOCUMENT_TEXT_DETECTION-Feature

Kontingent 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

Hinweis: Die Prominentenerkennung wird nicht mehr unterstützt. Wir empfehlen Ihnen, die Zugriffsvoraussetzungen unter Prominentenerkennung zu lesen, bevor Sie ein derartiges Kontingent anfragen.

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

Niedrigere Kontingente können in der Google Cloud Console pro Nutzer 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 Konfiguration.

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

• Gesamtanfragekontingent (Anfragen pro Minute) × Batchgröße >= erhöhtes Featurekontingent

Wenn Sie diese Anforderung nicht erfüllen, bleibt Ihr Gesamtanfragekontingent ein Drosselungsfaktor.

In diesem Dokument sind die aktuellen Inhaltslimits und Anfragekontingente für die Vision API aufgeführt. 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 von Bilddateien	20 MB
Größe von JSON-Anfrageobjekten	10 MB
Größe von PDF-Dateien	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 %).