atelier noir
API · v1

Développez sur
Atelier Noir.

Une API REST simple et sans détour : envoyez une photo produit, recevez en retour des visuels et des clips portés. L’utilisation est décomptée de votre forfait, exactement comme au studio.

Authentification

Créez une clé dans Studio → Settings → API & webhooks (propriétaires et administrateurs). Envoyez-la comme jeton Bearer. Les clés ne sont affichées qu’une seule fois et stockées sous forme hachée.

curl -X POST https://ateliernoir.ai/api/v1/generations \
  -H "Authorization: Bearer an_live_…" \
  -H "Content-Type: application/json" \
  -d '{"image_url":"https://your-cdn.com/product.jpg","frames":3}'
POST/generations

Lancez une génération à partir de l’URL d’une photo produit. L’image est téléchargée, analysée par l’antivirus et vérifiée comme un téléversement au studio.

{
  "image_url": "https://your-cdn.com/product.jpg",
  "frames": 3,            // 1–8, uses frame credits
  "model_id": "ml2609_greta",  // optional, defaults to your house model
  "set_id": "bg2209_resort_santorini", // optional
  "title": "SS27 · linen dress"
}
202 { "id": "cm…", "status": "queued", "poll": "/api/v1/generations/cm…" }
GET/generations/{id}

Statut, visuels (avec résultat du contrôle qualité) et clips.

{ "status": "completed", "frames": [{ "index": 1, "shot": "Full body", "url": "https://…/frame-001.jpg", "quality_check": "ok" }], "clips": [] }
POST/generations/{id}/clips

Créez un clip à partir d’un visuel finalisé. Utilise des crédits clip : reveal 1, motion 2, spin 2, runway 3.

{ "style": "runway", "frame_index": 1 }
202 { "id": "cm…", "status": "processing" }
GET/models

Modèles actifs dans la bibliothèque (id, nom, tags, image).

{ "models": [ … ] }
GET/sets

Décors actifs dans la bibliothèque (id, nom, catégorie, image).

{ "sets": [ … ] }

Erreurs : 401 clé invalide · 402 nombre de visuels ou de crédits clip insuffisant · 409 non prêt · 400 entrée invalide (avec un message).

Limites : image_url doit être une adresse http(s) publique, jusqu’à 25 MB, en JPG/PNG/WEBP/HEIC. Interrogez l’API toutes les quelques secondes ; les visuels prennent une à deux minutes, les clips environ trois minutes.

Shopify: connectez votre boutique dans Settings → Integrations pour envoyer des visuels directement vers un produit, depuis le studio.