Skip to main content
Cette page couvre les conventions qui s’appliquent à chaque endpoint. La référence complète, endpoint par endpoint — générée à partir de la spécification OpenAPI de l’API — se trouve dans les groupes de la barre latérale : Génération d’images, Édition d’images, Génération de vidéos, Entraînement de modèles, Modèles et Compte & utilisation. Pour un exemple complet de bout en bout, consulte le quickstart.

​
Base URL

​
Authentification

Chaque requête doit porter une API key d’organisation en tant que bearer token :
Les clés appartiennent à l’organisation, sont limitées par scope et affichées une seule fois à la création. Voir Créer une API key pour en obtenir une.

​
Conventions

  • Jobs asynchrones — les endpoints de génération renvoient 202 Accepted avec un id de job ; interroge l’endpoint GET correspondant pour le statut, ou fournis un webhook_url pour être notifié à la fin.
  • Statuts — les jobs passent par pending, processing, puis un état terminal completed, failed ou cancelled.
  • Scopes — la plupart des endpoints exigent un scope sur la clé (par exemple, images.generate) ; GET /me ne nécessite qu’une clé valide. Une clé à laquelle il manque un scope requis reçoit 403.
  • Erreurs — les réponses non-2xx renvoient un corps d’erreur JSON structuré avec un type, un code, un message et un request_id.
  • Credits — les actions puisent dans le pool de credits de l’organisation ; un pool épuisé renvoie 402.
  • Rate limits — les requêtes sont limitées par clé ; dépasser la limite renvoie 429 avec un header Retry-After.