var2_render_timeline
Build a PRECISE multi-track video timeline — explicit per-clip start times, overlaps, per-clip mute/volume/fades/trim, TEXT/CAPTION overlays with styling, audio tracks with offsets, and MOTION-GRAPHICS pieces as transparent overlays on top of the video (lower thirds, titles, end cards: a "motion" track) — and save it as an editable project (render=false, default) or queue the render (render=true). Accepts a simplified tracks[] or the raw GUI editor schema; captions turns word/line lyrics timestamps into a styled caption track server-side. Frames at 30fps are canonical; seconds fields are converted exactly. For simple back-to-back concatenation use var2_join_videos instead; status of a queued render → var2_check_join_status.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "var2_render_timeline"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| assets | No | Raw-schema mode: map of assetId → url / var2 share link / placeholder_id. | |
| render | No | Default false = save project only (user edits in GUI). true = also queue the render now. | |
| schema | No | RAW GUI editor ProjectSchema passthrough (fps/width/height/durationInFrames/tracks with startFrame+durationInFrames). Use with `assets`. A motion clip here is {type: "motion", motion: <full Motion Spec, with overlay: true to composite over the tracks below>, startFrame, durationInFrames, trimStart, style} on a track of type "motion"; prefer the simplified tracks[] form, which resolves project_id for you. | |
| tracks | No | Simplified timeline: [{type: video|image|audio|text|motion, muted?, clips: [{type?, asset? (url/share link/placeholder_id), text? (string or {content,fontSize,color,backgroundColor,alignment,bold}), start_seconds?, duration_seconds (required, except motion), trim_start_seconds?, muted?, volume?, fade_in_seconds?, fade_out_seconds?, label?, objectFit?}]}]. Omitted start_seconds appends after the previous clip in the track. MOTION GRAPHICS ON TOP OF VIDEO: a track of type "motion" (put it AFTER the video tracks — later tracks draw on top) with clips {project_id (a saved piece from var2_create_motion_graphics / var2_save_motion_graphics) | spec (inline Motion Spec), start_seconds, duration_seconds? (default: the piece's length; never longer), trim_start_seconds?, overlay? (default true: the piece's background is dropped so the video shows through; false keeps it opaque), opacity? (0–1), fade_in_seconds?, fade_out_seconds?, x?, y? (centre in % of the canvas, default 50/50), scale? (0.05–1 of the canvas, default 1), include_audio? (default false: also add the piece's own voice-over / music)}. The piece is fitted without stretching whatever its aspect ratio, is read fresh from project_id on every call (edit the piece, call again, the new version renders), and each piece may be up to 60 s while the timeline may be 10 min. | |
| captions | No | Server-computed caption/lyrics track — no frame math needed: {timestamps: [{text, start_seconds, end_seconds}] (word- OR line-level), max_words_per_caption? (word-level, default 4), style? (TextProps overrides), position? (bottom|top|center)}. Appended as a text track to the timeline. | |
| resolution | No | Default 1080p (render only). | |
| aspect_ratio | No | Default 16:9. |