Quotas et limites

Cloud Translation impose des quotas sur la taille du contenu des requêtes et le nombre de requêtes que vous pouvez envoyer. Les quotas préservent la communauté des utilisateurs de Google Cloud en empêchant les pics d'utilisation imprévus. Vous pouvez également réduire vos quotas pour éviter toute utilisation excessive et contrôler les coûts.

Si vous dépassez votre quota, Cloud Translation renvoie une erreur 403. Le message d'erreur indique Daily Limit Exceeded si vous avez dépassé un quota quotidien ou User Rate Limit Exceeded si vous avez dépassé un quota par minute.

Les quotas quotidiens sont réinitialisés à minuit (heure du Pacifique). Un délai de 24 heures peut donc s'écouler avant que les nouveaux quotas soient appliqués.

Les quotas v2 s'appliquent à Cloud Translation – Basic et les quotas v3 s'appliquent à Cloud Translation – Advanced. Vous pouvez afficher ou modifier vos quotas via la page Quotas sur Google Cloud Console.

Quotas de contenu

Les quotas de contenus s'appliquent aux chaînes de texte que vous envoyez à l'API Cloud Translation à l'aide des méthodes translateText et detectLanguage. Tous les caractères que vous envoyez à l'API Cloud Translation sont comptabilisés dans ces quotas, y compris les espaces blancs. Ces quotas sont cumulatifs si vous utilisez les deux versions Cloud Translation – Basic et Cloud Translation – Advanced.

Quota de contenu Par défaut
Caractères de modèles généraux v2 et v3 par jour et par projet Illimité
Caractères de modèles généraux v2 et v3 par minute et par projet 6 000 000 de caractères
Caractères de modèles généraux v2 et v3 par minute, par projet et par utilisateur* 6 000 000 de caractères

* Les quotas par utilisateur s'appliquent au nombre de requêtes par minute que peut effectuer un utilisateur final qui utilise une application client. Lorsque vous utilisez un compte de service, l'identité de ce compte de service est l'utilisateur auquel les quotas sont imputés. Si vous utilisez Cloud Translation – Basic et une clé API, Cloud Translation utilise l'adresse IP du client pour imposer cette limite.

L'API Cloud Translation est optimisée pour la traduction de requêtes plus petites. La longueur maximale recommandée pour chaque requête est de 5 000 caractères (points de code). Le nombre maximal de points de code pour une seule requête est de 30 000. Cependant, plus vous envoyez de caractères, plus la latence de réponse est élevée. L'API Cloud Translation refuse les requêtes qui dépassent la limite maximale et génère un message d'erreur 400 INVALID_ARGUMENT, quel que soit le quota disponible.

Quotas de requêtes

Cloud Translation applique un quota sur le nombre de requêtes que vous pouvez envoyer au service.

Quota Par défaut
Les quotas v2 et v3 sur les requêtes de langues disponibles par minute et par projet 600 requêtes
Requêtes v3 par minute et par projet 6 000 requêtes
Requêtes v3 par minute, par projet et par utilisateur* Illimité
Nombre total de requêtes de traduction par lot v3, par jour et par projet Illimité

* Les quotas par utilisateur s'appliquent au nombre de requêtes par minute que peut effectuer un utilisateur final qui utilise une application client. Lorsque vous utilisez un compte de service, l'identité de ce compte de service est l'utilisateur auquel les quotas sont imputés. Si vous utilisez Cloud Translation – Basic et une clé API, Cloud Translation utilise l'adresse IP du client pour imposer cette limite.

S'applique à tous les appels de méthode Cloud Translation – Advanced, à l'exception des méthodes translateText, detectLanguage, et getSupportedLanguages.

Quotas AutoML

Pour Cloud Translation – Advanced, vous pouvez utiliser des modèles d'AutoML pour traduire du contenu. Lorsque vous utilisez un modèle personnalisé, l'utilisation est comptabilisée dans un ensemble de quotas distinct. Pour en savoir plus sur les quotas de requêtes et de contenus AutoML, consultez la documentation AutoML Translation.

Comptage de quotas

Pour Cloud Translation – Basic, les quotas de requêtes et de contenus sont comptabilisés dans le projet qui envoie la requête, qui est déterminé par la clé utilisée dans la requête.

Pour Cloud Translation – Advanced, les quotas de contenus sont comparés avec le projet qui est associé au modèle dans la requête. Les quotas de requêtes sont comparés au projet qui envoie la requête.

Par exemple, dans la requête de traduction de texte suivante, les quotas de requête sont comparés au projet project-id-1, car la requête provient de ce projet.project-id-1 Les quotas de contenus sont comparés au projet project-id-2, car la requête utilise un modèle dans ce projet.

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."]
}

Limites de Cloud Translation – Advanced

Le tableau suivant décrit les limites définitives de Cloud Translation – Advanced.

Description Limite
Nombre maximal de fichiers que vous pouvez envoyer dans une requête à un seul lot 1 000 fichiers
Nombre maximal de ressources de glossaire pour un projet 1 000