atelier noir
API · v1

Build on
Atelier Noir.

Een kleine, eerlijke REST API: stuur een productfoto en ontvang on-model beelden en clips terug. Verbruik telt mee binnen uw plan, precies zoals in de studio.

Authenticatie

Maak een sleutel aan in Studio → Settings → API & webhooks (owners en admins). Verstuur die als Bearer-token. Sleutels worden één keer getoond en gehasht opgeslagen.

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

Start een generatie vanuit een URL van een productfoto. De afbeelding wordt gedownload, met antivirus gescand en gecontroleerd zoals bij een studio-upload.

{
  "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}

Status, beelden (met resultaat van de kwaliteitscontrole) en clips.

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

Maak een clip van een voltooid beeld. Gebruikt clipcredits: reveal 1, motion 2, spin 2, runway 3.

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

Actieve modellen in de bibliotheek (id, naam, tags, afbeelding).

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

Actieve sets in de bibliotheek (id, naam, categorie, afbeelding).

{ "sets": [ … ] }

Fouten: 401 ongeldige sleutel · 402 onvoldoende beelden of clipcredits · 409 niet gereed · 400 ongeldige invoer (met bericht).

Limieten: image_url moet een openbaar http(s)-adres zijn, tot 25 MB, JPG/PNG/WEBP/HEIC. Poll elke paar seconden; beelden duren één à twee minuten, clips ongeveer drie minuten.

Shopify: koppel uw winkel in Settings → Integrations om beelden vanuit de studio rechtstreeks naar een product te sturen.