var2_create_motion_graphics
Motion graphics with PIXEL-EXACT text: kinetic typography, animated titles, lower thirds, stat counters, logo stings, product / app launch videos, sale and quote cards, type over the user's own footage or photos. Drawn by code (0 % video generation), so words never garble and stay editable. USE THIS (not var2_create_video) when the deliverable is designed TEXT / graphics in motion; use var2_create_video for filmed-looking footage of people, places or scenes. READ var2_motion_catalog FIRST (styles, components, joins, physics). Modes: (1) composition — assemble reusable moments and motivated handoffs into a coherent film; free and deterministic. Search a varied shortlist, preserve coordinated mini-scenes, and inspect exact copy/timing in a free preview; (2) template + params (+ aspect_ratio, brand_kit_id) — preserve an entire requested template; free; (3) brief — the compiler writes the spec; put the exact on-screen words in quotes, one beat per line, plus mood / colors / pace (billed per second); (4) project_id (from any earlier motion result) or a spec you wrote, + instruction — revise it in plain language (billed like a compile); without an instruction, render:true renders it as-is (free). Media: image_urls (logos / photos → image layers, cutouts, frames, chips in the copy), footage_url (video or photo BEHIND the piece). Narration: voice_over {script|dialogue, voice} or voice_asset_id — every spoken phrase lands on screen as it is said; voice_convert re-voices it. Draft first: render:false (default) saves the piece as a draft (project_id, free) and returns warnings and human_summary (every word with its timing) while the user watches it play live in the chat; once they approve (the draft's "Render video" button posts "Looks good - render the final video (project )." - render THAT project), var2_save_motion_graphics { project_id, render: true } queues the MP4 and the chat shows it when done. Free alternatives: var2_preview_motion_graphics (compose or validate a spec) and var2_save_motion_graphics (editable project, optional free render). Template ids and params: var2_motion_catalog. Presets (briefs): kinetic, launch, stats, quote, list, countdown, lower-third, announcement.
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_create_motion_graphics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| font | No | Preferred font. Hebrew → Rubik / Heebo. | |
| name | No | ||
| spec | No | A Motion Spec you wrote: revise it with `instruction`, or render it as-is. For a piece a previous call made, pass its project_id instead. | |
| brand | No | Inline brand: {name, tone, messaging, colors, fonts, logo_url}. | |
| brief | No | What to make. Exact on-screen words in quotes, one beat per line; plus mood / colors / pace. | |
| colors | No | Brand colors (CSS: #hex / rgb()). | |
| params | No | Template params — var2_motion_catalog {template_id} lists each template's params with defaults and a ready call. | |
| preset | No | Optional starting brief (used when `brief` is empty, otherwise ignored). | |
| render | No | Default false: compile only - the user watches a live draft in the chat and confirms the words. true queues the MP4: only after the user approved the draft (or explicitly asked for the final video). | |
| overlay | No | true = an OVERLAY for video: no background is painted, so on a var2_render_timeline "motion" track the video shows through. Alone it sits on black. | |
| template | No | Template id (var2_motion_catalog section=templates). Alone = free instant build; with a brief = skeleton for the compiler. | |
| image_urls | No | https logos / photos the piece may place. | |
| project_id | No | A saved piece (every motion result returns project_id): revise it with `instruction`, or render:true renders it in place. | |
| resolution | No | Default 1080p. | |
| voice_over | No | Narrate first, then animate: script (or dialogue [{text, voice}]) + voice id. auto_tag (default true on v4) adds audio tags. Billed as a dialog. | |
| composition | No | {styleId,seed,beats:[{componentId,params,durationFrames?,physics?,rotation?,scale?,join?}]}. Catalog components/styles/physics/joins define the valid values. One coherent story, varied moments. | |
| footage_url | No | https video or photo BEHIND the piece. | |
| instruction | No | Plain-language change applied to `spec`. | |
| aspect_ratio | No | Default 16:9. | |
| brand_kit_id | No | The user's brand kit. | |
| voice_convert | No | Re-voice the narration with another voice id (speech-to-speech keeps the timing and the sync). | |
| voice_asset_id | No | Audio asset with word timestamps; the piece is timed to it. | |
| duration_seconds | No | Omit to let the compiler fit the copy (usually 5–12s). |