atelier noir
API · v1

Desenvolva com
Atelier Noir.

Uma REST API simples e transparente: envie a fotografia de um produto e receba imagens e clips com modelo. A utilização é contabilizada no seu plano, exatamente como no estúdio.

Autenticação

Crie uma chave em Studio → Settings → API & webhooks (owners e admins). Envie-a como token Bearer. As chaves são apresentadas uma única vez e armazenadas sob a forma de 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 uma geração a partir do URL da fotografia de um produto. A imagem é descarregada, analisada por antivírus e verificada como um carregamento no estúdio.

{
  "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, imagens (com resultado da verificação de qualidade) e clips.

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

Crie um clip a partir de uma imagem concluída. 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 ativos na biblioteca (id, name, tags, image).

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

Cenários ativos na biblioteca (id, name, category, image).

{ "sets": [ … ] }

Erros: 401 chave inválida · 402 imagens ou créditos de clip insuficientes · 409 não pronto · 400 input inválido (com uma mensagem).

Limites: image_url deve ser um endereço http(s) público, até 25 MB, JPG/PNG/WEBP/HEIC. Faça polling a cada poucos segundos; as imagens demoram um ou dois minutos, os clips cerca de três minutos.

Shopify: ligue a sua loja em Settings → Integrations para enviar imagens diretamente para um produto, a partir do estúdio.