atelier noir
API · v1

Üzerine inşa edin
Atelier Noir.

Küçük, dürüst bir REST API: bir ürün fotoğrafı gönderin, karşılığında model üzerindeki kareleri ve klipleri alın. Kullanım, tıpkı stüdyoda olduğu gibi planınızdan düşer.

Kimlik doğrulama

Studio → Settings → API & webhooks bölümünde bir anahtar oluşturun (sahipler ve yöneticiler). Bunu Bearer token olarak gönderin. Anahtarlar bir kez gösterilir ve hash'lenmiş olarak saklanır.

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

Bir ürün fotoğrafı URL'sinden bir üretim başlatın. Görsel indirilir, antivirüs taramasından geçirilir ve stüdyo yüklemesi gibi kontrol edilir.

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

Durum, kareler (kalite kontrol sonucu ile birlikte) ve klipler.

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

Tamamlanmış bir kareden bir klip oluşturun. Klip kredisi kullanır: Reveal 1, Motion 2, spin 2, Runway 3.

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

Kütüphanedeki aktif modeller (id, ad, etiketler, görsel).

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

Kütüphanedeki aktif set'ler (id, ad, kategori, görsel).

{ "sets": [ … ] }

Hatalar: 401 geçersiz anahtar · 402 yeterli kare veya klip kredisi yok · 409 hazır değil · 400 geçersiz girdi (bir mesajla birlikte).

Sınırlar: image_url, herkese açık bir http(s) adresi olmalıdır; en fazla 25 MB; JPG/PNG/WEBP/HEIC. Birkaç saniyede bir yoklayın; kareler bir-iki dakika, klipler yaklaşık üç dakika sürer.

Shopify: kareleri stüdyodan doğrudan bir ürüne göndermek için mağazanızı Settings → Integrations bölümünde bağlayın.