Skip to main content
Crée un modèle personnalisé dans l’une des quatre catégories — style, object, person ou setting — à partir de 1 à 10 images de référence. Une fois completed, le modèle peut être composé dans la génération d’images, Magic Edit et la vidéo stylisée.

​
Deux façons d’envoyer des images de référence

  • Inline — POST /models avec chaque image sous forme d’url https ou de base64 inline + mime_type. Le plus simple pour les petites images et les URLs distantes.
  • Presigned upload — pour les fichiers volumineux, appelle POST /models/prepare pour obtenir des presigned URLs PUT, envoie chaque fichier avec PUT, puis POST /models/{id}/complete pour lancer le traitement.
Les deux chemins nécessitent le scope models.write.

​
Instruction toujours appliquée

Chaque modèle porte une instruction optionnelle — une guidance toujours appliquée (max. 8000 caractères). Contrairement à un prompt par requête, elle est injectée comme directive obligatoire (“MUST FOLLOW”) dans chaque génération d’image et de vidéo qui compose le modèle, si bien que les règles de marque (“toujours un fond blanc uni”) s’appliquent sans les répéter à chaque appel. Elle est distincte du default_prompt du modèle — une description de capacités générée par IA qui est elle aussi ajoutée à la génération. Définis-la à la création et modifie-la à tout moment avec PATCH /models/{id} ; à la lecture, elle est renvoyée sous le nom user_instruction.

​
Modèle asynchrone

La création renvoie 202 Accepted avec un id de modèle ; interroge GET /models/{id}/status jusqu’à ce que status soit completed (ou failed). Un webhook_url te donne un callback push — voir Webhooks. La création de modèle est gratuite — son estimated_credits vaut 0 — mais nécessite toujours un abonnement d’organisation actif ; une organisation sans abonnement utilisable renvoie 402. Voir Pricing.