atelier noir
API · v1

Desarrolle sobre
Atelier Noir.

Una API REST pequeña y honesta: envíe una foto de producto y reciba imágenes y clips con modelo. El uso se descuenta de su plan, exactamente igual que en el estudio.

Autenticación

Cree una clave en Studio → Settings → API & webhooks (owners y admins). Envíela como token Bearer. Las claves se muestran una sola vez y se almacenan con 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

Inicie una generación a partir de la URL de una foto de producto. La imagen se descarga, se analiza con antivirus y se verifica igual que una carga en el estudio.

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

Estado, imágenes (con el resultado del control de calidad) y clips.

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

Cree un clip a partir de una imagen terminada. Utiliza créditos de clip: Reveal 1, Motion 2, spin 2, Runway 3.

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

Modelos activos en la biblioteca (id, nombre, etiquetas, imagen).

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

Escenarios activos en la biblioteca (id, nombre, categoría, imagen).

{ "sets": [ … ] }

Errores: 401 clave no válida · 402 no hay suficientes imágenes o créditos de clip · 409 no preparado · 400 entrada no válida (con un mensaje).

Límites: image_url debe ser una dirección http(s) pública, de hasta 25 MB, en JPG/PNG/WEBP/HEIC. Consulte el estado cada pocos segundos; las imágenes tardan uno o dos minutos, los clips unos tres minutos.

Shopify: conecte su tienda en Settings → Integrations para enviar imágenes directamente a un producto, desde el estudio.