Atelier Noir
API · v1

Construiți pe
Atelier Noir.

Un REST API mic și onest: trimiteți o fotografie de produs, primiți înapoi cadre și clipuri on-model. Utilizarea se contorizează în planul dumneavoastră, exact ca în studio.

Autentificare

Creați o cheie în Studio → Settings → API & webhooks (owners și admins). Trimiteți-o ca token Bearer. Cheile sunt afișate o singură dată și sunt stocate hash-uit.

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

Porniți o generație din URL-ul unei fotografii de produs. Imaginea este descărcată, scanată antivirus și verificată ca un upload în 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}

Status, cadre (cu rezultatul verificării de calitate) și clipuri.

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

Creați un clip dintr-un cadru finalizat. Folosește credite pentru clipuri: reveal 1, motion 2, spin 2, runway 3.

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

Modele active din bibliotecă (id, nume, taguri, imagine).

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

Decoruri active din bibliotecă (id, nume, categorie, imagine).

{ "sets": [ … ] }

Erori: 401 cheie invalidă · 402 cadre sau credite pentru clipuri insuficiente · 409 nu este pregătit · 400 input invalid (cu mesaj).

Limite: image_url trebuie să fie o adresă publică http(s), de până la 25 MB, JPG/PNG/WEBP/HEIC. Interogați la fiecare câteva secunde; cadrele durează un minut sau două, clipurile aproximativ trei minute.

Shopify: conectați-vă magazinul în Settings → Integrations pentru a trimite cadre direct către un produs, din studio.