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. Sie werden von Google Cloud-Diensten wie der 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 Höheres Kontingentlimit anfordern.
Für Vision-Ressourcen gelten außerdem Limits. Diese Beschränkungen stehen nicht im Zusammenhang mit dem Kontingentsystem. Beschränkungen können nur geändert werden, wenn dies angegeben ist.
Kontingenttypen
Es gibt drei Arten von Kontingenten:
- Anfragekontingent
- Das Kontingent zählt pro Anfrage, die an den Vision API-Endpunkt gesendet wird.
- 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.
- 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:
| Limits 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 %).