Limites de taux

Les limites de taux sont des restrictions que notre API impose sur le nombre de fois qu'un utilisateur ou un client peut accéder à nos services dans une période de temps spécifiée.

Pourquoi des limites

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

Pour garder notre service sûr et sain ! Pensez aux limites de taux comme des videurs amicaux - ils s'assurent que personne ne peut submerger notre API avec trop de requêtes à la fois. Cela aide à protéger notre service d'une utilisation abusive potentielle et à maintenir tout en bon état de fonctionnement.
Pour s'assurer que tout le monde obtient sa juste part. Tout comme partager des jouets dans une cour de récréation, nous voulons nous assurer que tous nos utilisateurs ont un accès égal à l'API. En limitant doucement le nombre de requêtes que chaque utilisateur peut faire, nous nous assurons que personne n'a à attendre trop longtemps pour son tour.
Pour garder la performance rapide et fiable. En gérant le flux global de 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 devient pas trop encombrée - le trafic circule mieux lorsque nous prévenons la congestion !

Comment fonctionnent les limites

Les limites de taux sont mesurées de deux manières :

Requêtes par seconde : C'est le nombre de requêtes réseau que vous pouvez faire 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 à tout moment.

Les tâches en file d'attente incluent Texte en 3D, Image en 3D, Texte en texture, et les endpoints Remaillage. D'autres endpoints comme Upload et Balance ne sont pas inclus dans cette limite.

Les limites sont appliquées sur une base par compte. Cela signifie que les limites sont partagées entre toutes vos API keys.

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

Chaque niveau utilisateur a des limites de taux spécifiques et des niveaux de priorité conçus pour correspondre à leurs 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	Par défaut à 50, peut être personnalisé	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 de dépassements qui peuvent déclencher cela, chacun avec une réponse différente :

Dépassement de requête : Cela se produit lorsque vous faites 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.