Créer un modèle
Crée un modèle à partir de 1 à 10 images de référence fournies en URLs ou en base64 inline.
202 Accepted avec un id de modèle ; interroge
GET /models/{id}/status jusqu’à completed.
Chacune des 1 à 10 images est soit une url https (téléchargée côté serveur
sous protections SSRF) soit du base64 inline + mime_type (image/jpeg, image/png,
ou image/webp, ≤ 10 Mo chacune). L’instruction optionnelle est la guidance toujours appliquée du
modèle — injectée comme directive obligatoire (“MUST FOLLOW”) dans chaque génération qui compose le modèle,
pas une simple note d’usage (modifie-la plus tard avec
PATCH /models/{id}). Nécessite le scope models.write.
Exemple : créer un modèle de style à partir d’URLs
url soit du base64 + mime_type, pas les deux. Pour les
fichiers volumineux, utilise plutôt le flux presigned upload.
category vaut l’une des valeurs style, object, person, setting.Autorisations
Organization API key as a bearer token: Authorization: Bearer samsa_sk_....
Corps
POST /models body — inline base64 and/or https-URL reference images.
1 - 100"Acme Brand Style"
Model category — one of style, object, person, setting.
style, object, person, setting "style"
1-10 reference images, each a url or inline base64+mime_type.
1 - 10 elementsOptional free-text guidance for how to use the model.
8000"Use for hero banners and social posts."
Optional https webhook notified once on terminal status (signed per the webhook signature scheme; see the webhooks docs).
"https://example.com/webhooks/samsa"
Réponse
Successful Response
202 body for POST /models and POST /models/{id}/complete (ADR §7.1).
The created model's id — poll GET /models/{id}/status.
Initial status: pending (create) or processing (complete).
pending, processing, completed, failed "pending"
Credits the finished job will cost (model creation is free = 0).
0

