atelier noir
API · v1

Build on
Atelier Noir.

Niewielkie, przejrzyste REST API: przesłanie zdjęcia produktu, odbiór ujęć i klipów on-model. Zużycie jest naliczane w ramach planu — dokładnie tak jak w studiu.

Uwierzytelnianie

Tworzenie klucza w Studio → Settings → API & webhooks (właściciele i administratorzy). Należy przesyłać go jako token Bearer. Klucze są wyświetlane tylko raz i przechowywane w postaci hashowanej.

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

Rozpoczęcie generacji na podstawie adresu URL zdjęcia produktu. Obraz jest pobierany, skanowany antywirusowo i weryfikowany tak jak przesłanie do studia.

{
  "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, ujęcia (z wynikiem kontroli jakości) i klipy.

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

Tworzenie klipu z gotowego ujęcia. Wykorzystuje kredyty na klipy: Reveal 1, Motion 2, spin 2, Runway 3.

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

Aktywne modele w bibliotece (id, nazwa, tagi, obraz).

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

Aktywne scenografie w bibliotece (id, nazwa, kategoria, obraz).

{ "sets": [ … ] }

Błędy: 401 nieprawidłowy klucz · 402 niewystarczająca liczba ujęć lub kredytów na klipy · 409 niegotowe · 400 nieprawidłowe dane wejściowe (z komunikatem).

Ograniczenia: image_url musi być publicznym adresem http(s), do 25 MB, w formacie JPG/PNG/WEBP/HEIC. Sprawdzanie statusu co kilka sekund; ujęcia zajmują minutę lub dwie, klipy około trzech minut.

Shopify: połączenie sklepu w Settings → Integrations umożliwia przesyłanie ujęć bezpośrednio do produktu, ze studia.