style, object, person, or
setting — from 1–10 reference images. Once completed, the model can be composed
into image generation,
Magic Edit, and
styled video.
Two ways to submit reference images
- Inline —
POST /modelswith each image as anhttpsurlor inlinebase64+mime_type. Simplest for small images and remote URLs. - Presigned upload — for large files, call
POST /models/prepareto get presigned PUT URLs,PUTeach file, thenPOST /models/{id}/completeto start processing.
models.write scope.
Asynchronous pattern
Creation returns202 Accepted with a model id and an estimated_credits
figure; poll GET /models/{id}/status until
status is completed (or failed). A webhook_url gives you a push callback —
see Webhooks. Credits draw from your organization’s pool; an
exhausted pool returns 402. See Pricing.