Skip to main content
POST
Make a pre-production image for a film
Makes one reference image for a script, in one of 8 modes: Costs 3 credits at 1k, 4 at 2k (default) and 6 at 4k. Add up to 14 referenceImageUrls. params takes optional per-mode settings: cinematography for every mode (cinematic, anime, realistic, cartoon, fantasy, …); age and gender for face; camera-angle for first-frame; color-palette, lighting-mood and era-vibe for style-collage. Poll Poll image status with generation.id.

Authorizations

Authorization
string
header
required

An Unsora API key (uns_…). A Clerk session token also works.

Body

application/json
prompt
string
required

Description of the character, place or scene.

mode
enum<string>
required

face close-up portrait; wide-body full body; sheet character turnaround; location set reference; first-frame opening shot; style-collage look and feel; multishot-2x4 and multishot-1x4 storyboard grids.

Available options:
face,
wide-body,
sheet,
location,
first-frame,
style-collage,
multishot-2x4,
multishot-1x4
params
object

Optional per-mode settings: cinematography (every mode, default cinematic); age (default adult) and gender (default female) for face; camera-angle (default eye-level) for first-frame; color-palette (default warm), lighting-mood (default natural) and era-vibe (default modern) for style-collage.

ratio
enum<string>
default:16:9
Available options:
auto,
1:1,
9:16,
16:9,
4:3,
3:4
resolution
enum<string>
default:2k
Available options:
1k,
2k,
4k
referenceImageUrls
string<uri>[]

Up to 14 reference images, e.g. of the actor or the set.

Maximum array length: 14

Response

Job queued

success
boolean
required
generation
object
required
creditsDeducted
integer
creditsRemaining
integer