Skip to main content
Use a series when you’ll make more than one episode with the same people and places. You save the show once; every episode is then written from it, with a recap of the earlier episodes, and opens with the show’s title card and theme. Saving and changing a series is free. Each episode is a normal Director job, priced like an AI-written film plus its recap and packaging.

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_s seconds (default 10). Instead of uploading one, send theme_auto=true or a theme_brief to have it made once — 36 credits, charged when the series is saved.
  • laugh_track (light or full) 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:
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.
Without pictures or voices, the first episode’s become the show’s own. Limits: cast 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=true drops the theme.
  • DELETE /director/series/{id} deletes it. Episodes already made stay as your jobs.