Atelier Noir
API · v1

Build on
Atelier Noir.

Eine kleine, ehrliche REST API: Senden Sie ein Produktfoto, und Sie erhalten On-Model-Bilder und Clips zurück. Die Nutzung wird Ihrem Tarif angerechnet — genau wie im Studio.

Authentifizierung

Erstellen Sie einen Schlüssel in Studio → Settings → API & webhooks (Inhaber und Admins). Übermitteln Sie ihn als Bearer-Token. Schlüssel werden einmal angezeigt und gehasht gespeichert.

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

Starten Sie eine Generierung über die URL eines Produktfotos. Das Bild wird heruntergeladen, per Antivirus geprüft und wie ein Studio-Upload kontrolliert.

{
  "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, Bilder (mit Ergebnis der Qualitätsprüfung) und Clips.

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

Erstellen Sie einen Clip aus einem fertigen Bild. Verwendet Clip-Credits: reveal 1, motion 2, spin 2, runway 3.

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

Aktive Models in der Bibliothek (id, name, tags, image).

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

Aktive Sets in der Bibliothek (id, name, category, image).

{ "sets": [ … ] }

Fehler: 401 ungültiger Schlüssel · 402 nicht genügend Bilder oder Clip-Credits · 409 nicht bereit · 400 ungültige Eingabe (mit einer Nachricht).

Limits: image_url muss eine öffentliche http(s)-Adresse sein, bis zu 25 MB, JPG/PNG/WEBP/HEIC. Fragen Sie den Status alle paar Sekunden ab; Bilder benötigen ein bis zwei Minuten, Clips etwa drei Minuten.

Shopify: Verbinden Sie Ihren Store in Settings → Integrations, um Bilder direkt aus dem Studio an ein Produkt zu senden.