API Pro : limites, codes d'erreur et bonnes pratiques

Limites

Chaque clé en comporte trois : rendus simultanés (2 par défaut), soumissions par minute (60 par défaut) et, si tu en définis une, un plafond de crédits journalier.

Quand une limite est atteinte, la réponse est 429 avec un header Retry-After en secondes. Un appel refusé ne coûte rien. Le jour utilisé pour les limites est le jour UTC.

Notre propre carte est partagée avec les utilisateurs de l'app. Quand elle est occupée, tes rendus sont envoyés vers des GPU loués, au même tarif et via la même API, avec quelques dizaines de secondes supplémentaires au démarrage.

Codes d'erreur

Code	error	Ce que ça signifie, et quoi faire
400	champ prompt requis	Ajoute un prompt.
400	contenu_interdit	Le filtre de contenu a refusé le prompt.
400	image_requise, inpaint_images_requises	Le mode nécessite image_b64, et mask_b64 pour inpaint.
401	cle_requise, cle_invalide	Header absent ou clé inconnue.
402	credits_insuffisants	Solde insuffisant pour ce rendu (cost est indiqué). Recharge sur le site.
403	cle_desactivee, cle_revoquee, cle_expiree	Clé désactivée, révoquée ou expirée : crée-en une nouvelle dans l'app.
403	licence_revoquee, licence_non_pro	Licence révoquée, ou compte qui n'est pas Pro.
403	portee_manquante	La clé ne dispose pas de la permission demandée, indiquée dans portee.
403	lora_inconnu	Un personnage qui n'appartient pas au compte.
404	media_indisponible	Le fichier n'existe plus : soumets à nouveau.
413	image_trop_lourde	Image source ou masque dépassant 12 Mo décodés.
429	trop_de_rendus_simultanes, cadence_minute, plafond_jour	Une limite est atteinte, consulte Retry-After.
429	plafond_credits_jour	Le plafond de crédits journalier de la clé est atteint (plafond, depense, cout).
502	soumission_echouee, statut_echoue	Un incident côté rendu : réessaie dans quelques secondes.
503	licence_inverifiable	Le compte ne peut pas être vérifié en ce moment : réessaie dans une minute.

Les noms d'erreur sont les chaînes exactes renvoyées par l'API. Appuie-toi sur elles plutôt que sur le message, qui peut être reformulé.

Bonnes pratiques

• Interroge toutes les 3 secondes, pas plus vite. La file d'attente est partagée, et la surcharger ne sert à rien.
• Télécharge dès que le statut est completed. Le fichier n'est pas archivé.
• Rédige les prompts en anglais, et pour les vidéos, décris le mouvement plutôt que l'image fixe.
• Une clé par usage, et un plafond de crédits journalier sur chaque clé hébergée sur un serveur. Une clé compromise avec un plafond te coûte une journée, pas tout ton solde.
• Considère un 429 comme normal, pas comme un échec : attends le Retry-After et continue.

Les prompts sont enregistrés de notre côté, comme pour l'app, à des fins de sécurité.