How it fits together
Save a series
POST /api/v1/director/series — multipart or JSON. Answers 201 with the series.
- Title card is on by default and reads “NAME / Episode N: Title”.
- Theme plays under the opening for
theme_sseconds (default 10). Instead of uploading one, sendtheme_auto=trueor atheme_briefto have it made once — 36 credits, charged when the series is saved. laugh_track(lightorfull) puts studio-audience laughs in every episode (16 credits an episode).- Name is required, up to 200 characters. At most 50 series per account (
409 conflict).
Add the cast
Two ways:- One member at a time
- All at once
POST /director/series/{id}/cast adds a member, or changes one matched by name. Answers with the whole series.voice is 5–15 s of them speaking.name 60, what 400, voice_what 200 characters. Over a limit returns 400 invalid_request naming the field (e.g. cast.what).
Remove a member, or only their picture or voice, with DELETE /director/series/{id}/cast/{name} (?part=picture or ?part=voice). Read a member’s files at GET …/cast/{name}/picture or …/voice, and the series’ pictures at GET /director/series/{id}/picture?n=1.
Make an episode
POST /api/v1/director/series/{id}/episodes answers 202 with a Director job. Poll it like any job.
?dry_run=true is free and returns the quote. Drop it to make the episode.
Price: an AI-written film of that length + 76 for the recap + packaging (title card and theme), plus the series’ laugh track or a package.score when set. A 60 s episode is 775 credits.
After it renders
GET /director/series/{id}/episodes lists every episode with its title, idea, recap, open threads, lasting changes, what the show learned, status and jobId — the episode’s Director job, so you can download, retake or finish it.
Redo and final work on an episode exactly like on a film: POST /director/videos/film/{jobId}/redo and …/final.
Changing and deleting
POST /director/series/{id}changes a series — send only what changes.remove_theme=truedrops the theme.DELETE /director/series/{id}deletes it. Episodes already made stay as your jobs.
