AI agents: fetch the documentation index at llms.txt. Markdown versions are available by appending .md to any page URL, including this page's markdown.
shots.json and stills.json
Schema, ordinal contract, hard rules, and lint warnings for film authoring files.
The CLI validates both files with zod (src/shots.ts). Every object is strict — a misspelled key is a load-time error. Always --dry-run first.
Rules are model-dependent, keyed off film.model. A file with no film.model is validated as Seedance 2.0 (the CLI default). Set "model": "dreamina-seedance-2-5-260628" for 2.5 rules.
Worked examples:
examples/shots-2-5.json— 2.5, two 30s actsfilms/lighthouse/shots.json+stills.json— 2.0, twelve 8s shots, full pipeline
stills.json
Generated first with vs stills. Locks the look: literal opening composition of every shot, plus character, prop, or environment plates.
{
"model": "gemini-3-pro-image",
"outputDir": "./stills-v2",
"ratio": "1:1",
"stills": [