Code film
code_filmA short film made in code, the default for a short for a feed (a YouTube Short, an Instagram Reel, a TikTok, a post's video): motion design, type, the business's own pictures and products, music and sound, no generated video. With run false nothing is laid out or spent and the answer is its quote: what it makes (shape, length, who reads it: say that voice, never another), what it costs at the director the owner's plan gives it, with the plan first and the film made from the plan, and the other director's price beside it; say the film's price (tokens), that the plan comes first (planFirst) and the most both together may use (mostInAll). With run true it is laid out now: the plan is written first (the only spend now) and waits on its page in Create, where the owner reads it, changes shots if they like and presses Make. run true only when the owner clearly asked to make it now. available false: films in code cannot run here now; say why, and canvas_film can make the film instead. It needs an act key, and spends the owner's tokens as the chat's same tool would: say the price before you spend.
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": {
"goal": "<goal>",
"purpose": "<purpose>",
"platform": "<platform>"
},
"name": "code_film"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| run | No | true lays it out now: the plan comes first and waits on its page in Create for the owner's Make; false only prices it | |
| goal | Yes | what the film is for and what happens in it, in a few lines: the owner's ask, the trend or the offer, who it is for | |
| energy | No | how lively it is; auto lets the brief decide | |
| project | No | The project's id or exact name. Optional when the account has one project. | |
| purpose | Yes | sell (a product), launch (something new), show (a story or an episode), trend (rides something trending now: find the trend first, among the Trend agent's current trends (agent_open trend) or in this week's news (web_research), and name it in the goal and to the owner), offer (a deal), laugh (a joke) | |
| seconds | No | its length in seconds, 5 to 60; omit and Marsell makes it 8 to 20 seconds | |
| director | No | how strong a model writes and draws it: only when the owner picks one; omit and the owner's plan decides (Standard on Solo, Pro above it) | |
| platform | Yes | where it goes, which sets its shape: reels (Instagram Reels, YouTube Shorts and any tall 9:16 feed), tiktok (9:16), feed (4:5), facebook (4:5), ad (1:1), x, linkedin or wide (16:9) | |
| productIds | No | products it shows, by their ids |