Limites de débit

Les limites de débit sont des restrictions que notre API impose sur le 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 pour aider à créer la meilleure expérience possible pour tous. Voici pourquoi elles sont importantes :

Pour garder notre service sain et sauf ! Considérez les limites de débit comme des videurs sympathiques - elles s'assurent que personne ne puisse submerger notre API avec trop de requêtes à la fois. Cela permet de protéger notre service contre les abus potentiels et de maintenir un fonctionnement fluide.
Pour s'assurer que tout le monde ait sa juste part. Tout comme le partage de jouets dans une cour de récréation, nous voulons nous assurer que tous nos utilisateurs aient un accès égal à l'API. En limitant doucement le nombre de requêtes que chaque utilisateur peut effectuer, nous garantissons que personne n'ait à attendre trop longtemps pour son tour.
Pour garder des performances rapides et fiables. En gérant le flux global des requêtes, nous pouvons maintenir des temps de réponse rapides et un service stable pour tous nos merveilleux utilisateurs. C'est comme s'assurer qu'une autoroute ne soit pas trop encombrée - la circulation est meilleure lorsque nous évitons la congestion !

Comment fonctionnent les limites

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

Requêtes par seconde : c'est le nombre de requêtes réseau que vous pouvez effectuer par seconde.
Tâches en file d'attente : c'est le nombre de tâches de génération concurrentes que vous pouvez exécuter en file d'attente à un moment donné.

Les tâches en file d'attente incluent les endpoints Texte en 3D, Image en 3D, Texte en texture et Remaillage. D'autres endpoints comme Upload et Balance 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 API keys.

Outre les 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 utilisateur	Requêtes par seconde	Tâches en file d'attente	Niveau de priorité
Pro	20	10	Par défaut
Premium	20	30	Supérieur à Pro
Ultra	20	100	Le plus élevé
Studio	20	20	Supérieur à Pro
Enterprise	100	100 par défaut, personnalisable	Le plus élevé

Si vous dépassez ces limites, vous recevrez une réponse 429 Too Many Requests de notre API. Il existe deux types d'occurrences pouvant déclencher cela, chacune avec une réponse différente :

Dépassement 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.
Dépassement de file d'attente : cela se produit lorsque vous avez trop de tâches de génération concurrentes en cours d'exécution. Vous recevrez une réponse 429 Too Many Requests avec un message NoMoreConcurrentTasks.