SceneVela
SCENEVELA API v1

Developer quickstart

Keep API keys on your server. Never embed them in browser or mobile code.

Keys with generation:create or generation:read must be bound to one active project UUID when created. Requests never fall back to your currently selected UI project.

1. Request a trusted quote

curl https://scenevela.com/api/v1/developer/quotes \
  -H "Authorization: Bearer sv_live_EXAMPLEPREFIX_EXAMPLE_SECRET_REPLACE_ME" \
  -H "Content-Type: application/json" \
  -d '{"kind":"image","mode":"text","modelId":"flux-2-pro","aspectRatio":"1:1","resolution":"1K"}'

2. Submit the generation

curl https://scenevela.com/api/v1/developer/generations \
  -H "Authorization: Bearer sv_live_EXAMPLEPREFIX_EXAMPLE_SECRET_REPLACE_ME" \
  -H "Idempotency-Key: order_12345678" \
  -H "Content-Type: application/json" \
  -d '{"quoteToken":"QUOTE_TOKEN_FROM_STEP_1","prompt":"A cinematic product photograph"}'

Successful output URLs are short-lived and private. Repeat the GET request when a fresh URL is needed.

Download OpenAPI 3.1