var2_video_effect
Add a designed VIDEO EFFECT to a talking-head clip: graphics that sit INSIDE the footage - behind the person, in front of them, following their head - or that treat the footage as an object (a phone, an app window, a card). Use for "cards orbiting my head", "put a title behind me", "magazine cover", "viewfinder zoom", "pull back to show it in an app", "sticker outline", "checklist beside me". The first use of a clip prepares it once (the person is cut out frame by frame, in var2's own renderer); later effects on the same part of the clip reuse it. SEVERAL effects on one clip = ONE call with sequence: [{ effect, from_seconds, to_seconds, params }] - one piece, a different effect on each part of the clip (a call per effect makes a separate video per effect). The clip's length is read from the file: a step that runs past its end is refused with the real length. Returns an editable motion piece (editor_url) and a timeline_clip for var2_render_timeline; render=true also starts the finished video (the clip with the effect and the clip's sound): the answer names it in placeholder_ids and var2_check_join_status waits for it. If it answers state "preparing" (first use of a clip: it is being cut out, which takes a few minutes for a long clip), call it again with the same arguments: it picks up the same preparation and never starts a second one. Tell the user it is on its way; never loop. INSTANT AND FREE (graphics that only lie over the clip; nothing is prepared, saved at once): vfx-phone-card, vfx-checklist, vfx-name-tag, vfx-speech-bubble, vfx-arrow-callout, vfx-confetti, vfx-progress-bar, vfx-cta-button, vfx-letterbox, vfx-stamp, vfx-headline-top, vfx-check-pills, vfx-tier-list, vfx-film-frame, vfx-phone-fan, vfx-comment-reply, vfx-timeline. Every other effect prepares the clip first; when that has a price the answer says it (preparation_credits, charged once per clip), and an effect from the instant list never has one. Instant effects can be on screen TOGETHER (bars and a name tag): one call each without render, then one var2_render_timeline with a motion track per piece (overlay: true); a sequence only puts effects one after another. Texts on screen are SHORT - a label about 25 characters, a heading about 30, a row about 35, a tag about 14: a longer one is cut at a whole word and ends with "...", and the answer's warnings name each text that was cut. Effects:
vfx-orbit: Cards circle the speaker in real 3D: behind the body on the far side, in front on the near side. Each card is drawn by the engine from words, a picture, or both, and the cards can fly in and out on a spiral. Params: cards (up to 10 cards, three kinds: "a short title" (words only), "https://…" (picture only), or { title, subtitle, eyebrow, image, color } (words over / under a picture). Fewer than 6 are repeated to fill the ring); layout (ring (default: around the chest) | crown (a ring above the head) | arc (cards drift across an arc in front of the chest) | gaze (a ring across the frame above the speaker, at the place they look at most; it stays still, and its near cards pass in front of the hair)); enter (spiral (default: cards fly in one by one) | open (the ring grows from its centre)); exit (spiral (default) | open); facing (spin | tilt | camera (default spin)); card_layout (stack (picture above the words, default) | overlay (words over the picture)); text_size (size of the words on the cards, 0.5–2 (default 1). A card object may carry its own text_size); seconds_per_lap (default 4); radius (gaze layout only: half the width of the ring, percent of the frame width. Default: the whole width of the frame. Smaller (minimum 22 upright / 12 landscape) and it sits toward the side they look at most; it never moves during the clip).
vfx-screen-wall: A drifting wall of pictures fills the room behind the speaker. Params: images (2–40 image URLs).
vfx-ui-world: The whole frame becomes an app page: the clip plays in a rounded tile and the speaker's head rises out of its top edge; thumbnails drop into a prompt box and a command is typed. Params: greeting (line above the tile, e.g. "Afternoon, Simone"); command (the text typed into the box, e.g. "/videoeffects"); status (small status pill, e.g. "Running skill · video-effects").
vfx-frame-break: The room dims, the shot shrinks into a phone frame behind the speaker, and the speaker stays full size in front of it, breaking out of the frame. Params: device (phone | card (default phone)).
vfx-digital-zoom: A camera viewfinder (corner marks, battery, REC light, zoom readout) while the shot punches in on the face in steps. Params: zoom (strongest punch-in, 1.15–1.7 (default 1.45)).
vfx-phone-card: An app sheet in front of the speaker, rising from the bottom of the frame (beside the speaker, at the top, in landscape): steps tick off one by one, then the button turns green. Params: title (sheet heading); steps (up to 5 short steps; "text | tag" adds a right-hand tag); cta (button label).
vfx-checklist: A translucent dark panel in front of the speaker: a header with a live "2 of 5" count, then rows that tick green one by one, each with a small tag on the right. Params: title (panel heading); items (up to 6 rows; write "text | tag" to add a right-hand tag); position (bottom | top (default bottom)).
vfx-headline-wall: Newspaper clippings drop in around the head and pile up behind the speaker; the last one lands in front. Params: headlines (up to 8 short headlines).
vfx-zoom-through: A crash zoom into the speaker's face with motion blur and a flash: a cut into the next shot. Put it on the last half second of a clip. Params: strength (how far it pushes in, 2–5 (default 3.4)).
vfx-chart-grow: A glowing line chart draws itself behind the head; each point shows its value and the last one lands as a bold tag. Params: points (3–8 values (any scale)); color (line colour); prefix (before each value, e.g. "$"); suffix (after each value, e.g. "K", "%"); values (false hides the value labels).
vfx-pull-back: The camera pulls back from the shot to show it is a card on an app page (file name, Ready badge, clip chips, buttons), and the whole page tilts in 3D. Params: file_name (e.g. "reel_final.mp4"); badge (e.g. "Ready"); button (main button label, e.g. "Download").
vfx-green-screen: Split frame: the raw green-screen card on top, the cut-out speaker large below.
vfx-paper-cut: A scrapbook page: the speaker becomes a black-and-white sticker with a white edge on a yellow disc, caption words land as coloured pills, sticker shapes pop in around. Params: words (up to 8 caption words, shown as pills at the top); disc (disc colour).
vfx-doodle-boil: A wobbling hand-drawn outline around the speaker, with doodles popping beside the head. Params: color (line colour (default white)).
vfx-vertigo: A dolly zoom: the room pushes in and softens around the head while the speaker barely grows. Params: amount (0.04–0.14 (default 0.09)).
vfx-cover-story: A magazine cover: a giant title over the head with its foot tucked behind the hair, cover lines in front, a thin frame. Params: title (the masthead word); lines (up to 3 short cover lines); caption (one line under the speaker).
vfx-glass-type: A huge glass word fills the width behind the head and settles with a liquid wobble. Params: word (one word, up to 8 letters (a name works well)).
vfx-name-tag: A lower third: the name on an accent bar with the title under it, sliding in at the bottom left. Params: name (the name); title (role or handle (optional)).
vfx-spotlight: The room dims and softens and a pool of warm light sits behind the speaker, who stays sharp and bright. Params: strength (0.2–0.8 (default 0.5)).
vfx-halo: A glowing ring pulses behind the head and follows it. Params: color (ring colour).
vfx-caption-behind: Huge caption words land one at a time BEHIND the speaker, rising from behind the top of the head: the hair hides only the foot of each word, so it stays readable. Params: words (up to 12 words or very short phrases, shown one after another); frames_per_word (default: spread evenly over the clip); color (word colour (every second word uses the accent)).
vfx-speech-bubble: A comic speech bubble pops up beside the top of the head and moves with it; its tail grows out of the bubble and points down at the speaker. Params: text (what the bubble says (short)); side (left | right (default right)); color (bubble colour (default white)).
vfx-color-pop: The room turns black and white while the speaker stays in full colour.
vfx-background-swap: The room is replaced: the speaker stands in front of a picture you give, or a colour gradient. Params: image (https image URL for the new background (optional)); color (gradient start colour when no image is given); blur (0–20, softens the picture (default 4)).
vfx-echo: Ghost copies of the speaker, each a little larger, lag a few frames behind every move like a motion trail. Params: copies (1–3 ghosts (default 3)); lag_frames (frames between ghosts (default 3)).
vfx-neon-outline: A glowing neon line traces the speaker's silhouette while the room darkens. Params: color (line colour); width (4–16 (default 8)).
vfx-arrow-callout: A hand-drawn arrow and a label point at the speaker and move with them. Params: label (the label (short)); side (left | right (default left)).
vfx-big-stat: A huge number counts up behind the head (beside the speaker in landscape), with a label under it. Params: value (the number to count to); prefix (e.g. "$"); suffix (e.g. "%", "K", " tools" (6 characters at most)); label (one short line under the number (40 characters at most)).
vfx-confetti: Confetti bursts behind the speaker and a little falls in front: a celebration beat.
vfx-split-screen: The clip becomes a rounded tile on one side; a title and talking points land one by one on the other. Params: title (heading); points (up to 4 short points).
vfx-reaction-pip: A picture you give fills the frame and the speaker shrinks into a round bubble in the corner, reacting to it. Params: image (https image URL to show full screen (required)); corner (left | right (default left)).
vfx-sticker-burst: Your own pictures pop in around the head as white-edged stickers, some behind the speaker and some in front, and move with the head. Params: images (1–8 https image URLs (cut-outs with a transparent background look best)).
vfx-progress-bar: A thin bar across the top fills as the clip plays, so viewers see how much is left. Params: color (bar colour).
vfx-cta-button: A button pops up near the bottom, a cursor flies in and clicks it, and it turns green. Params: label (button text before the click, e.g. "Follow for more"); done (text after the click, e.g. "Following").
vfx-letterbox: Black cinema bars slide in from the top and bottom and a small title sits on the lower bar. Params: title (text on the lower bar (optional)).
vfx-countdown: Huge numbers count down behind the top of the head (beside the speaker in landscape), one per second. Params: from (start number, 2–9 (default 3)); color (number colour).
vfx-stamp: A rubber stamp slams onto the frame at an angle, in front of the speaker. Params: word (the stamped word, e.g. "NOPE" / "APPROVED"); color (ink colour (default red)).
vfx-scribble: The footage turns black and white, and a hand-drawn circle is scrawled round the face with a note beside it. Params: note (short handwritten note, e.g. "me →"); color (pen colour (default red)).
vfx-poster: A bold poster: black-and-white speaker, a giant red word behind, and three stacked lines in front. Params: word (the giant word behind); lines (up to 3 short lines in front); color (accent colour (default red)).
vfx-headline-top: A white band with a big headline; one word is highlighted. By default it lies over the bottom of the frame, in front of the speaker, and is added at once. position "top" puts the band above the shot and lowers the shot beneath it, so nothing of the speaker is covered: that prepares the clip like an effect behind the person (not instant). Params: headline (the headline (2–6 words)); highlight (one word of it to highlight); color (highlight colour); position (bottom | top (default bottom)).
vfx-check-pills: Blue pills with ticks pop up around the speaker one by one, like features being switched on. Params: labels (up to 6 short labels); color (pill colour).
vfx-tier-list: A tier list builds row by row in a dark panel in front of the speaker (S at the top, F at the bottom). Params: tiers (up to 6 rows; write "S | Claude" (letter | what goes there)).
vfx-film-frame: The clip sits inside a strip of film: black edges with sprocket holes and a stock name printed along the bottom. Params: stock (text printed on the film edge, e.g. "KODAK 400 · 21").
vfx-key-rain: Keyboard keys drop in around the head, some behind the speaker and some in front, and bob in place. Params: keys (up to 8 key labels, e.g. ["⌘", "Z", "K"]).
vfx-rabbit-hole: The clip appears inside itself again and again in white frames, each smaller: a tunnel of the same shot. Params: depth (2–3 nested frames (default 3)).
vfx-phone-fan: A hand of phones fans out across the bottom of the frame in front of the speaker, each showing one of your pictures. Params: images (2–5 https image URLs (screens or posters)).
vfx-face-lock: Camera focus marks snap onto the face and track it, with a small label under them. Params: label (small label under the marks (optional)); color (mark colour).
vfx-comment-reply: A viewer comment pops up above the head, then a reply slides in under it: the "comment X and I'll send it" moment. Params: comment (the viewer comment, e.g. "EFFECTS"); reply (the reply, e.g. "Sent you the pack"); name (commenter name (default "you")).
vfx-timeline: An editing timeline rises along the bottom: rows of clip blocks with a playhead sweeping across, and a title in the corner. Params: title (corner title, e.g. "AUTO-EDIT"); color (block colour (default red)).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"video": "<video>"
},
"name": "var2_video_effect"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| video | Yes | The clip: a var2 video placeholder_id, a var2 share link, or an https URL. Works best with one person facing the camera. | |
| effect | No | Which effect. See the tool description for what each one looks like and its params. | |
| params | No | The effect's own parameters (all optional; each effect has sensible defaults). | |
| render | No | true = also render the finished video (the clip with the effect, with the clip's sound); the answer says how to wait for it (var2_check_join_status). Default false: save an editable piece and show a live preview. | |
| sequence | No | INSTEAD of effect: several effects over one clip, one after another, in one piece (a different effect every couple of seconds, like an edited reel). Times are positions in the clip; steps may not overlap; the clip plays plainly in any gap. | |
| resolution | No | ||
| to_seconds | No | Where it ends. Default from_seconds + 6, never past the clip's end (its length is read from the file). At most 60 seconds per call. | |
| aspect_ratio | No | The shape of the finished piece. Default: the clip's own shape (read from the file). Pass it only to reframe the clip. | |
| from_seconds | No | Where in the clip the effect starts. Default 0. | |
| wait_seconds | No | How long this call may wait for the clip to be prepared (default 40). Leave it at the default: most clients drop a tool call after 60 seconds, and the call does a little work before and after the wait. Preparing a clip for the first time usually takes under two minutes; asking again picks up the same preparation. |