Generate a brand-aware video clip
generate_videoStart video generation from a text prompt. Choose a budget or premium tier, set aspect ratio and target platforms, then poll the returned job until the video is ready.
Instructions
Kick off a video generation and return a Job. Two tiers: tier='budget' (default) uses Wan 2.1 — 40 credits per clip. tier='premium' uses Kling v2.1 / Runway Gen4 — 300 credits, Build plan or higher only. Poll with get_job until status='completed'. Aspect ratios optimised for short-form social: 9:16 (Reels/TikTok), 16:9 (YouTube), 1:1 (feed).
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": {
"prompt": "<prompt>"
},
"name": "generate_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tier | No | Quality / cost tier. 'budget' (default, 40 credits) uses Wan 2.1 and is available on every plan. 'premium' (300 credits) uses Kling v2.1 / Runway Gen4 and requires a Build plan or higher — Free/Hobby projects get a 402 plan_required. | |
| prompt | Yes | What the video should show. Be visual: action verbs, camera movement, mood. e.g. 'cinematic top-down shot of pour-over coffee, slow motion, warm morning light'. | |
| platforms | No | Target platforms — affects formatting / pacing. Default ['tiktok','instagram']. | |
| aspect_ratio | No | Default 9:16 (vertical for Reels/TikTok). | |
| visual_style | No | Style note, e.g. 'cinematic_realistic', 'anime', 'product_studio'. | |
| duration_seconds | No | Clip length. Default 5. Longer clips may use multiple model calls. |