atelier noir
API · v1

Sviluppi su
Atelier Noir.

Una REST API piccola e trasparente: invii una foto prodotto, riceva scatti e clip indossati. L’utilizzo viene conteggiato sul Suo piano, esattamente come nello studio.

Autenticazione

Crei una chiave in Studio → Settings → API & webhooks (owners e admins). La invii come token Bearer. Le chiavi vengono mostrate una sola volta e salvate in forma hash.

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

Avvii una generazione da un URL di foto prodotto. L’immagine viene scaricata, sottoposta a scansione antivirus e verificata come un caricamento in 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}

Stato, scatti (con risultato del controllo qualità) e clip.

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

Crei una clip da uno scatto completato. Utilizza crediti clip: reveal 1, motion 2, spin 2, runway 3.

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

Modelli attivi nella libreria (id, nome, tag, immagine).

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

Set attivi nella libreria (id, nome, categoria, immagine).

{ "sets": [ … ] }

Errori: 401 chiave non valida · 402 scatti o crediti clip insufficienti · 409 non pronto · 400 input non valido (con un messaggio).

Limiti: image_url deve essere un indirizzo http(s) pubblico, fino a 25 MB, JPG/PNG/WEBP/HEIC. Verifichi ogni pochi secondi; gli scatti richiedono uno o due minuti, le clip circa tre minuti.

Shopify: colleghi il Suo store in Settings → Integrations per inviare gli scatti direttamente a un prodotto, dallo studio.