For AI agents: the documentation index is at /llms.txt. Append .md to any page URL, or send Accept: text/markdown, for the Markdown version of that page.
For AI agents: the documentation index is at llms.txt. Markdown versions are available by appending .md to any page URL, including this page's markdown.
Run a film end to end — ladder, draft/final, ceilings, retakes, and audio.
This is the operating guide for staging a film through vs. For the why behind each rung, see Cost ladder.
vs doctor
vs generate films/<slug>/shots.json --dry-run
vs stills films/<slug>/stills.json
vs animatic films/<slu
Published with Edda
Commands run as vs after npm link, or as node dist/cli.js <cmd> from the repo root. Run npm run build first if dist/ is stale.
Leave film.draftModel unset. With it unset, --draft runs the film's own model at 480p (45% of final).
Promote one act before drafting the rest. The seed is portable across passes but the composition is not guaranteed to survive a resolution change. Compare one act at 480p vs 720p at the same seed. If it re-rolls, drafting the other acts teaches you nothing — go straight to finals.
Catch envelope mismatches for free:
vs generate films/<slug>/shots.json --dry-runvs generate films/<slug>/shots.json --shot s06-drive-breaks --force
vs stills films/<slug>/stills.json --still s06-drive-breaks --force
vs status films/<slug>/shots.json
vs use films/<slug>/shots.json s06-drive-breaks v001An in-flight task is never resubmitted — the manifest re-attaches by task id. Result URLs expire in about 24 hours, so generate downloads immediately and drops the presigned URL from the manifest once the file is on disk.
If a run was interrupted after submission:
vs status films/<slug>/shots.json --refresh
vs download films/<slug>/shots.json--no-wait on generate submits without polling when you want to split submission from collection.
Per-shot prompts only ask for SFX and ambience. Score and voiceover are mixed at stitch time:
vs score → score-vNNN.mp3vs narrate from lines.tsv → line-NN.mp3vs narrate assemble --xfade … → narration.mp3vs stitch --xfade … --music … --narration …Re-stitch with both whenever a shot is regenerated. Match --xfade (and per-shot transition overrides) on assemble and stitch.
--concurrency defaults to 3 for generate and 2 for stills. Seedance 2.5 is capped at 1 concurrent task at every resolution — a 30s generation takes 10–15 minutes, so a six-act film is 60–90 minutes strictly serial. Plan the session around that.
--json on every command (automatic when stdout is not a TTY)--verbose for stack traces--yes with --max-cost--dry-run exists on everything that spends money or shells out to ffmpeg--output always resolves against the cwd, not the film directoryAt any point, assemble the best available source per shot (final → draft → still):
vs stitch films/<slug>/shots.json --latest