Quotas et limites

Ce document présente les restrictions et les quotas d'utilisation actuellement appliqués à l'API Cloud Translation. Cette page est mise à jour lorsque ces restrictions et limites d'utilisation sont modifiées.

Ces quotas s'appliquent à chaque projet de développeur et à chaque utilisateur de l'API Cloud Translation. Ils sont partagés entre toutes les applications et versions d'API associées à un projet de développeur donné.

Vous pouvez modifier les quotas dans la limite des valeurs maximales autorisées à l'aide de Google Cloud Console. Pour demander une augmentation supérieure aux valeurs maximales autorisées pour un quota, envoyez une demande depuis la page Google Cloud Console.

Quotas de contenu

Le contenu est fourni à l'API Cloud Translation sous forme de chaînes de texte. La tarification et l'utilisation sont basées sur le nombre de caractères. Tous les caractères envoyés à l'API Cloud Translation, y compris les espaces, sont comptabilisés dans ces quotas.

Les quotas quotidiens sont réinitialisés à minuit (heure du Pacifique).

L'API Cloud Translation est optimisée pour la traduction de requêtes courtes. La longueur maximale recommandée pour chaque requête est de 2 000 points de code. L'API Cloud Translation rejette les requêtes trop volumineuses et génère un message d'erreur 400 INVALID_ARGUMENT, quel que soit le quota disponible.

Les quotas basés sur le nombre de caractères s'appliquent aux méthodes translateText et detectLanguage. La limite stricte imposée pour les requêtes est de 30 000 caractères Unicode (points de code).

Quota de contenu Par défaut Maximum Durée Applicable à
Caractères de modèles généraux par jour 1 milliard illimité jour projet
Caractères de modèles généraux pour 100 secondes par projet 1 000 000 de caractères 10 000 000 de caractères 100 secondes projet
Caractères de modèles généraux pour 100 secondes par projet par utilisateur 100 000 caractères 10 000 000 de caractères 100 secondes projet et utilisateur

Si vous dépassez votre quota, Cloud Translation - Basic renvoie une erreur 403. Le message d'erreur indique Daily Limit Exceeded si vous avez dépassé la limite quotidienne, ou User Rate Limit Exceeded si vous avez dépassé l'un des quotas "caractères de modèles généraux pour 100 secondes".

Pour afficher ou modifier les limites d'utilisation de votre projet, ou pour demander une augmentation des quotas, procédez comme suit :

  1. Si vous ne possédez pas encore de compte de facturation pour votre projet, créez-en un.
  2. Accédez à la page "API activées" de la bibliothèque d'API dans la console GCP, puis sélectionnez une API dans la liste.
  3. Sélectionnez Quotas pour afficher et modifier les paramètres associés aux quotas. Pour afficher les statistiques d'utilisation, sélectionnez Utilisation.

Quotas de requêtes

Outre les quotas de contenu décrits ci-dessus, Cloud Translation impose des quotas sur l'utilisation de l'API.

Requêtes de découverte des langues disponibles

Pour Cloud Translation Basic et Advanced, la fréquence à laquelle vous pouvez demander la liste des langues disponibles pour la traduction est limitée.

Ce quota ne s'applique pas aux textes envoyés pour être traduits, mais uniquement aux requêtes liées à la liste des langues disponibles.

Quota Par défaut Maximum Durée Applicable à
Requêtes liées à la liste des langues disponibles 1 000 requêtes 1 000 requêtes 100 secondes projet

Version Advanced

Pour Cloud Translation, le nombre de requêtes que vous pouvez envoyer est limité. Ce quota s'applique à tous les appels de méthode Cloud Translation à l'exception de translateText, detectLanguage et getSupportedLanguages. translateText utilise Caractères de modèles généraux pour 100 secondes pour les modèles généraux (voir ci-dessus), et Caractères de modèles AutoML par minute pour les modèles AutoML personnalisés. detectLanguage et getSupportedLanguages sont couverts par les quotas Caractères de modèles généraux pour 100 secondes et Requêtes liées à la liste des langues compatibles pour 100 secondes, respectivement (voir ci-dessus). batchTranslationText est couvert par Caractères de traduction par lots v3 utilisant des modèles généraux par projet par jour pour les modèles généraux, et Caractères de traduction par lots v3 utilisant des modèles personnalisés AutoML par projet par jour pour les modèles personnalisés  AutoML. Ces deux quotas sont illimités par défaut et réinitialisés à minuit (heure du Pacifique).

Ce quota ne s'applique pas aux requêtes envoyées à Cloud Translation – Basic.

Activité Quota par défaut Durée Applicable à
Requêtes v3 par défaut par projet 6 000 60 secondes projet
Requêtes v3 par défaut, par projet et par utilisateur illimité 60 secondes projet et utilisateur
Caractères de modèles AutoML par projet 100 000 60 secondes projets
Caractères de modèles AutoML par projet par utilisateur illimité 60 secondes projet et utilisateur
Caractères de traduction par lots utilisant des modèles généraux par projet illimité 1 jour projet
Caractères de traduction par lots utilisant des modèles personnalisés AutoML par projet illimité 1 jour projet

Modèles (version Advanced uniquement)

Lorsque vous utilisez un modèle personnalisé ou général, le quota de contenu est comparé avec l'ID du projet associé au modèle. Les quotas de requête sont comparés au projet associé à la requête.

Prenons par exemple la requête de traduction suivante :

POST https://translation.googleapis.com/v3/projects/project-id-1/locations/us-central1:translateText
{
"Model":"projects/project-id-2/locations/us-central1/models/model-id",
    "sourceLanguageCode": "en",
    "targetLanguageCode": "ru",
    "contents": ["Dr. Watson, please discard your trash."]
}

Les quotas de requête sont comparés avec project-id-1, mais le quota de contenus est comparé avec project-id-2.