Limites de débit

Les limites de débit sont des restrictions que notre API impose au nombre de fois qu’un utilisateur ou un client peut accéder à nos services au cours d’une période donnée.

Pourquoi des limites

Nous avons mis en place des limites de débit sur notre API afin de contribuer à créer la meilleure expérience possible pour tout le monde. Voici pourquoi elles sont importantes :

  • Pour garder notre service sûr et fiable ! Considérez les limites de débit comme des videurs bienveillants : elles s’assurent que personne ne peut submerger notre API avec trop de requêtes à la fois. Cela aide à protéger notre service contre une éventuelle utilisation abusive et permet à tout de fonctionner sans accroc.

  • Pour nous assurer que chacun obtient sa juste part. Comme lorsqu’on partage des jouets dans une aire de jeux, nous voulons nous assurer que tous nos utilisateurs disposent d’un accès équitable à l’API. En limitant doucement le nombre de requêtes que chaque utilisateur peut effectuer, nous veillons à ce que personne n’ait à attendre trop longtemps son tour.

  • Pour maintenir des performances rapides et fiables. En gérant le flux global des requêtes, nous pouvons conserver des temps de réponse rapides et un service stable pour tous nos formidables utilisateurs. C’est comme s’assurer qu’une autoroute ne devient pas trop encombrée : le trafic circule mieux quand on évite les embouteillages !

Fonctionnement des limites

Les limites de débit sont mesurées de 2 façons :

  • requêtes par seconde : il s’agit du nombre de requêtes réseau que vous pouvez effectuer par seconde.
  • tâches en file d'attente : il s’agit du nombre de tâches de génération simultanées que vous pouvez exécuter dans la file d’attente à un moment donné.

Les tâches en file d’attente incluent les points de terminaison Texte en 3D, Image en 3D, Texte en texture et Remaillage. Les autres points de terminaison, comme Téléversement et solde, ne sont pas inclus dans cette limite.

Les limites sont appliquées par compte. Cela signifie que les limites sont partagées entre toutes vos clés API.

En plus des limites de débit, la priorité de traitement des tâches affectera également la vitesse de vos tâches.

Chaque niveau utilisateur dispose de limites de débit et de niveaux de priorité spécifiques conçus pour répondre à ses besoins. Voici les limites actuelles par niveau :

Niveau utilisateurrequêtes par secondetâches en file d'attenteNiveau de priorité
Pro2010Par défaut
Studio2020Plus élevée que Pro
Enterprise10050 par défaut, personnalisableLa plus élevée

Si vous dépassez ces limites, vous recevrez une réponse 429 Too Many Requests de notre API. Deux types d’atteintes peuvent déclencher cela, chacun avec une réponse différente :

  • Atteinte de requêtes : cela se produit lorsque vous effectuez trop de requêtes par seconde. Vous recevrez une réponse 429 Too Many Requests avec un message RateLimitExceeded.
  • Atteinte de file d’attente : cela se produit lorsque trop de tâches de génération simultanées sont en cours d’exécution. Vous recevrez une réponse 429 Too Many Requests avec un message NoMoreConcurrentTasks.