Ce document recense les quotas et limites système qui s'appliquent à Cloud Vision.
- Les quotas spécifient la quantité d'une ressource partagée dénombrable que vous pouvez utiliser. Ils sont définis par des services Google Cloud tels que Cloud Vision.
- Les limites système sont des valeurs fixes qui ne peuvent pas être modifiées.
Google Cloud utilise des quotas pour garantir l'équité et réduire les pics d'utilisation et de disponibilité des ressources. Un quota limite la quantité d'une ressourceGoogle Cloud que votre projet Google Cloud peut utiliser. Les quotas s'appliquent à différents types de ressources, y compris les composants matériels, logiciels et réseau. Par exemple, ils peuvent limiter le nombre d'appels d'API à un service, le nombre d'équilibreurs de charge utilisés simultanément par votre projet ou le nombre de projets que vous pouvez créer. Ils protègent la communauté des utilisateurs deGoogle Cloud en empêchant la surcharge des services. Les quotas vous aident également à gérer vos propres ressources Google Cloud .
Le système Cloud Quotas permet d'effectuer les opérations suivantes :
- Surveiller votre consommation de produits et services Google Cloud
- Limiter votre consommation de ces ressources
- Demander des modifications de la valeur du quota et automatiser les ajustements de quota
Dans la plupart des cas, lorsque vous tentez d'utiliser une ressource plus que son quota ne le permet, le système bloque l'accès à la ressource et la tâche que vous essayez d'effectuer échoue.
Les quotas s'appliquent généralement au niveau du projet Google Cloud . Votre utilisation d'une ressource dans un projet n'affecte pas votre quota disponible dans un autre projet. Dans un projet Google Cloud , les quotas sont partagés entre toutes les applications et adresses IP.
Pour ajuster la plupart des quotas, utilisez la console Google Cloud . Pour en savoir plus, consultez Demander un ajustement de quota.
Des limites système s'appliquent également aux ressources Vision. Elles ne peuvent pas être modifiées.
Types de quotas
Il existe trois types de quotas :
- Quota de requêtes
- Le quota comptabilise chaque requête envoyée au point de terminaison de l'API Vision.
- Quota de fonctionnalités
- Le quota comptabilise chaque image et chaque page envoyée au point de terminaison de l'API Vision.
- Sauf indication contraire, un quota qui a comme préfixe un nom de fonctionnalité est généralement un quota de fonctionnalités.
- Pour les requêtes
files:annotate, si le champpagesn'est pas spécifié explicitement, le quota sera de cinq pages par fichier. Toutefois, seul le nombre réel de pages traitées sera facturé aux utilisateurs.
- Quota de traitements
- Le quota comptabilise chaque image et chaque page en cours de traitement par l'API Vision, sauf indication contraire explicite.
- Il est reconnaissable par la mention "en cours de traitement" dans son nom.
- Ce quota détermine le nombre maximal d'images ou de pages que l'API Vision traite simultanément pour les méthodes asynchrones. Les utilisateurs peuvent envoyer plus que ce quota dans les méthodes asynchrones, mais les images ou pages qui dépassent ce quota ne sont pas traitées immédiatement. Les fichiers dépassant le quota sont ajoutés à une file d'attente afin d'être traités ultérieurement.
Voici les quotas d'utilisation actuels de l'API Vision (sous réserve de modification) :
| Quota de l'API Vision | Type de quota | Valeur |
|---|---|---|
| Requêtes par minute (sauf pour les types de requêtes ci-dessous) | Quota de requêtes | 1 800 |
| Requêtes de reconnaissance de célébrités par minute | Quota de requêtes | 0 |
| Requêtes de détection de thèmes par minute | Quota de fonctionnalités | 1 800 |
| Requêtes de détection de texte par minute | Quota de fonctionnalités | 1 800 |
| Annotation asynchrone d'images* (nombre d'images en cours de traitement) | Quota de traitements | 8 000 |
| Détection asynchrone de documents texte† (nombre de pages en cours de traitement) | Quota de traitements | 10 000 |
| * | Requêtes images:asyncBatchAnnotate |
| † | Requêtes files:asyncBatchAnnotate, fonctionnalité DOCUMENT_TEXT_DETECTION |
| Quota de recherches de produits | Valeur |
|---|---|
| Requêtes par minute (sauf pour les types de requêtes ci-dessous) | 1 800 |
| Requêtes par lot, par jour | 300 |
| Requêtes d'écriture pour la gestion des ressources, par minute | 1 200 |
| Requêtes pour la gestion des ressources, par minute | 2 400 |
Ces limites s'appliquent à tous les projets de la console Google Cloud . Elles sont partagées entre toutes les applications et adresses IP associées à chacun des projets.
Il est possible de définir des quotas inférieurs par utilisateur dans la consoleGoogle Cloud .
Augmentation des quotas
Pour modifier les quotas dans la limite des valeurs maximales autorisées, accédez à la page Quotas de la consoleGoogle Cloud et sélectionnez MODIFIER LES QUOTAS. Pour demander un dépassement du quota maximal, modifiez le quota selon l'augmentation souhaitée et envoyez votre demande accompagnée d'une raison justifiant cette modification. Vous recevrez une notification confirmant la réception de votre requête. Vous pouvez être contacté pour fournir des informations supplémentaires. Une fois votre demande examinée, vous serez notifié de son approbation ou de son refus.
Généralement, chaque quota comporte des variantes "par projet et par utilisateur" et "par projet". Veuillez les modifier en fonction de votre configuration.
Lorsque vous demandez une augmentation du quota de fonctionnalités, tenez compte du quota global de requêtes et de la taille du lot prévue afin de respecter la condition suivante :
- Quota global de requêtes (requêtes par minute) * taille de votre lot >= quota de fonctionnalités après augmentation
Si vous ne respectez pas cette exigence, vous serez toujours limité par le quota de requêtes global.
Ce document présente les limites de contenus et les quotas de requêtes actuellement appliqués pour l'API Vision. Il sera mis à jour en cas de modifications de ces restrictions et limites.
Limites
Les limites d'utilisation ci-dessous sont appliquées à l'API Vision :
| Limite de contenu | Valeur |
|---|---|
| Taille du fichier image | 20 Mo |
| Taille de l'objet de requête JSON | 10 Mo |
| Taille du fichier PDF | 1 Go |
Nombre d'images par requête images:annotate |
16 |
Nombre d'images par requête images:asyncBatchAnnotate |
2000 |
Pages par requête files:annotate |
5 |
Pages par requête files:asyncBatchAnnotate |
2000 |
Les images encodées en base64 peuvent dépasser la limite de taille JSON, même si elles sont comprises dans la limite de la taille du fichier image. Les images plus volumineuses doivent être hébergées sur Cloud Storage ou sur une URL accessible publiquement. Notez que la taille de fichier des images encodées en base64 peut être supérieure à celle du fichier image d'origine (d'environ 37 %, généralement).