Raw schema
{
"type": "object",
"properties": {
"url": {
"description": "Page URL whose scripts register timelines in `window.__timelines`\n(GSAP-style objects with `duration()` + `pause(t)`).",
"type": "string"
},
"fps": {
"description": "Frames per second. Default 24.",
"type": "number",
"format": "double",
"default": 24
},
"width": {
"description": "Viewport width in CSS pixels (floored to even — yuv420p). Default 1280.",
"type": "integer",
"format": "uint32",
"minimum": 0,
"default": 1280
},
"height": {
"description": "Viewport height in CSS pixels. Default 720.",
"type": "integer",
"format": "uint32",
"minimum": 0,
"default": 720
},
"hold_tail_secs": {
"description": "Freeze the final timeline state for this many extra seconds. Default 0.5.",
"type": "number",
"format": "double",
"default": 0.5
},
"max_duration_secs": {
"description": "Safety cap on timeline + hold tail, seconds. Default 120.",
"type": "number",
"format": "double",
"default": 120
},
"wait_timelines_ms": {
"description": "How long to wait for `window.__timelines` to appear, ms. Default 10000.",
"type": "integer",
"format": "uint64",
"minimum": 0,
"default": 10000
},
"use_proxy": {
"description": "Route through proxy (for blocked foreign sites)",
"type": "boolean",
"default": false
},
"tls_fingerprint": {
"description": "TLS fingerprint override (stealth mode only)",
"type": [
"string",
"null"
],
"default": null
},
"audio": {
"description": "Background music: looped to cover the video, volume-scaled, faded\nout at the tail.",
"anyOf": [
{
"$ref": "#/$defs/RenderVideoAudio"
},
{
"type": "null"
}
],
"default": null
},
"narration": {
"description": "Voiceover clips, each starting at its own time (any TTS output;\nmixed into one AAC track).",
"type": "array",
"items": {
"$ref": "#/$defs/RenderNarrationClip"
},
"default": []
},
"subtitles_srt": {
"description": "Inline SRT subtitles muxed as a soft (toggleable) mov_text track.",
"type": [
"string",
"null"
],
"default": null
},
"subtitles_language": {
"description": "ISO language tag for the subtitle track, e.g. \"eng\" / \"zh\".",
"type": [
"string",
"null"
],
"default": null
},
"burn_subtitles": {
"description": "Burn the cues into the frame pixels too (hardsub) — on by default\nwhen `subtitles_srt` is present; QuickTime, WeChat and most social\nembeds ignore the soft mov_text track. `false` keeps the soft track\nonly.",
"type": [
"boolean",
"null"
],
"default": null
}
},
"required": [
"url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$defs": {
"RenderVideoAudio": {
"description": "render_video `audio`: background music track — fetched, looped to cover\nthe video, volume-scaled, optionally faded out at the end.",
"type": "object",
"properties": {
"url": {
"description": "URL of the music file. mp3/wav/ogg/m4a — probed by content.",
"type": "string"
},
"volume": {
"description": "Linear multiplier 0..=2; 1 = as authored. Default 1.",
"type": "number",
"format": "float",
"default": 1
},
"fade_out_secs": {
"description": "Fade out over the final N seconds. Default 0 (none).",
"type": "number",
"format": "float",
"default": 0
},
"loop_audio": {
"description": "Loop to cover the whole video. Default true.",
"type": "boolean",
"default": true
}
},
"required": [
"url"
]
},
"RenderNarrationClip": {
"description": "render_video `narration[]`: one voiceover clip placed at a start time —\ngenerate with any TTS, hand us the URL; all clips mix into one AAC track.",
"type": "object",
"properties": {
"url": {
"description": "URL of the voice clip (any TTS output; mp3/wav/ogg/m4a).",
"type": "string"
},
"start_secs": {
"description": "Seconds from video t=0 where this line starts. Default 0.",
"type": "number",
"format": "double",
"default": 0
},
"volume": {
"description": "Linear multiplier 0..=2. Default 1.",
"type": "number",
"format": "float",
"default": 1
}
},
"required": [
"url"
]
}
}
}