storyboard: true with an idea on POST /director/videos/film: the writer plans the film, one still is drawn per shot, and the job waits for you.
Use it for anything long or expensive — explainers, documentaries, commercials — where a wrong shot is cheaper to catch as a still than as a 15-second clip.
Storyboards need an
idea (the writer plans the shots to draw) and work on one version at a time: variants must be 1. Otherwise the request returns 400 invalid_request.The flow
1
Start the film with storyboard on
2
Wait until it's ready for you
Poll the job. When the stills are drawn,
storyboard.waiting becomes true. The status stays running — that’s deliberate, so existing clients don’t break.3
Review it
All free. The storyboard answer is
{ object: "director.storyboard", jobId, waiting, stills, sheetUrl, storyboard }.4
Redraw what's wrong
POST /director/jobs/{id}/storyboard/redo with a JSON body:note, the same shot is simply drawn again.5
Approve
done.What it costs
You pay for the stills actually drawn, not the allowance held: the job settles at its quote with the allowance replaced by the real count. Redraws are charged one at a time — held when you ask, charged when the studio takes it, given back if it refuses. A redraw with too few credits returns
402.
Errors
Related
- Recipes — a documentary with a storyboard, end to end
- Jobs and statuses
- Billing and limits
