Gemini chat video
create_gemini_conversationCreate a Gemini conversation animation (replies revealed from top to bottom, a thinking animation before each reply, the reply's action row and disclaimer, your message typed on the keyboard, the side drawer with your chats, photos in your messages): each messages turn is the user's (typed into the input bar with the keyboard up, then sent — typed: false makes it appear at once) or the assistant's (a thinking animation for thinkingDuration seconds with an optional thinkingLabel, then the reply is revealed from top to bottom at streamingSpeed chars/s (default 100), then the action row fades in; error fails the reply instead). Replies keep their blank lines; lines starting with "* " or "- " draw as bullet points. A new chat opens on the home screen: the first message is typed there, and the conversation's title appears halfway through the first thinking phase. title is the conversation's title, placeholder the input bar's hint, sourceLabel the label beside the logo ("" hides it), disclaimer the line under the last reply ("" hides it), keyboard auto / always / never. A user turn's image ({ src }: an https image URL, never a data: URL) attaches a photo to the message. Other screens take their texts / rows by screen id (home, drawer). flow walks through the app's screens (chat, home, drawer) with fade / drawer / push / pop transitions; showTaps (default true) draws a touch indicator before each move. All options controllable. Images: every image field takes an https URL from an allowed host (see /integrations), or upload:<short-label> (e.g. upload:contact-avatar) when the user wants to use their own image — including one attached to this chat, which cannot be passed to tools. Never ask the user to host an image somewhere: the returned link asks them to add each upload: image from their device before it exports. Use the same label for the same image and a different label for a different one. Free-plan exports include a MockClip watermark and the free plan includes 2 MCP renders; if the caller is on the free plan, mention that they can upgrade at /pricing for watermark-free exports and more renders.
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": {
"messages": "<messages>"
},
"name": "create_gemini_conversation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flow | No | ||
| home | No | ||
| theme | No | ||
| title | No | ||
| drawer | No | ||
| sceneId | No | Stage the clip on a scene instead of a flat frame. Overrides videoFormat and showBezel: the export takes the scene's aspect. Two kinds. 3D close-up — a 3D phone filmed by a camera that flies in close to each new message, card or banner as it appears, with depth of field and motion blur: "closeup" (9:16), "closeup-wide" (16:9). Hand-held — the clip composited onto real footage of a hand holding a phone, for a filmed look; vertical 9:16: "outdoors" (outdoors), "bookshelf" (bookshelf), "two-hands" (two hands), "on-desk" (on the desk), "dim-room" (dim room); landscape 16:9 (YouTube, presentations): "city-wide" (city), "desk-wide" (desk), "neon-wide" (neon), "studio-wide" (studio). Default: none. | |
| keyboard | No | ||
| messages | Yes | ||
| showTaps | No | ||
| showBezel | No | Draw the iPhone bezel around the screen (default true). With 1:1 it frames the top of the phone; false gives a plain frame. | |
| textScale | No | Text size: a zoom of the phone UI (text, bubbles, avatars, bars, keyboard, notification banners) as a multiplier from 1 (default, the app's real size) to 1.5, in steps of 0.1 — use it when a short conversation or a single notification should fill the screen. Chat and notification apps only; the other apps ignore it. | |
| disclaimer | No | ||
| placeholder | No | ||
| sourceLabel | No | ||
| videoFormat | No | Output aspect ratio. "1:1" is a square for feed posts: chat apps fit the conversation into the square, the other apps show the top of the screen (phone-call ignores it). "9:16", "9:19.5" (iPhone) and "3:2" apply with showBezel false. "16:9" (widescreen) is for the notification tools with background.backgroundType "floating" only, where the frame is a photo scene and any aspect ratio applies without a bezel; on any other clip it is ignored. Default: the iPhone bezel, 9:16. | |
| exportFormat | No | Output file. "mp4" (default) and "gif" are opaque. "webm" (VP9) and "mov" (ProRes 4444, large files) keep an alpha channel: the only way a transparent background, or the corners around the phone bezel, stay transparent. With background.backgroundType "transparent" and no exportFormat the clip exports as webm. Transparent WebM / MOV export needs a Creator or Studio plan; on other plans the clip is made as mp4 and the reply says so. | |
| exportQuality | No | Resolution and frame rate of the file: "720p" or "1080p" (Full HD) at 15, 24, 30 or 60 fps, e.g. "1080p-30". Default "720p-30". Full HD takes up to 4× as long to export; 60 fps about twice as long and needs a Creator or Studio plan — on other plans the clip is made at 30 fps and the reply says so. | |
| showStatusBar | No | Draw the iOS status bar (time, signal, battery) at the top of the screen (default true). Applies with showBezel false or a sceneId: inside the iPhone bezel the status bar is always drawn, so to remove it set showBezel false too. | |
| soundSettings | No | ||
| thinkingLabel | No | ||
| sceneBackground | No | Backdrop behind the phone on a 3D close-up scene (sceneId "closeup" / "closeup-wide"): a colour as "#RRGGBB" — the backdrop is a soft gradient made from it, so a brand colour or a dark one both work — or "transparent" for the phone alone over an alpha channel, to lay over other footage (the clip then exports as webm unless exportFormat says otherwise; mp4 and gif cannot carry it and get the default backdrop). Default: a light blue. Ignored without a 3D close-up scene. | |
| showHomeIndicator | No | Draw the iOS home indicator bar at the bottom of the screen (default true). |