Skip to main content
A storyboard lets you check a film shot by shot before paying for the render. Send 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.
Branch on storyboard.waiting, not on stage. While waiting, stage isn’t meant for this decision.
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:
Answers with the updated storyboard once the new still is ready. Without a note, the same shot is simply drawn again.
5

Approve

Answers with the job. Keep polling it as usual until 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.
A storyboard you never approve still pays for its writing and its stills. Cancel it with DELETE /director/jobs/{id} if you’ve decided not to make it.

Errors