Make screen scene
make_screen_sceneShow the real product: turn one of the brand's app screenshots into a short clip at the format's size, with a slow push-in or pan, inside a phone, tablet or browser frame (or full screen). 5 credits, no generation. Returns a task_id at once; the clip takes up to a minute, so follow with get_task. Its video_url goes straight into render_video as video.url.
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": {
"format": "<format>"
},
"name": "make_screen_scene"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| focus | No | Where a push-in heads, as fractions of the frame; default the middle | |
| image | No | Or a stored screenshot (uploads/..., assets/...) or a public https image | |
| device | No | auto picks from the screenshot's shape: phone for tall, tablet for near-square, browser for wide. none fills the frame with the screenshot. | auto |
| format | Yes | ||
| motion | No | push_in: slow move towards focus. pull_out: the reverse. pan_down / pan_up: drift down or up (a tall screenshot with device none scrolls). still: no movement. | push_in |
| seconds | No | ||
| asset_id | No | A screenshot in the brand kit (get_brand lists them). With brand_id and no asset_id or image, the kit's first screenshot. | |
| brand_id | No | A brand kit from list_brands (id or name). Brings the colours, fonts, logo, website and default copy (headline, call to action, small print); use instead of brand. | |
| status_bar | No | Phone screens: true when the screenshot starts at the app's own header with no phone status bar (captured in a browser); a status bar in the header's colour goes above it, so the camera island doesn't cover the header. | |
| caption_room | No | Where the captions will go; the device leaves them a clear band. Default top on 9:16 (a bigger phone). Use bottom when the captions must sit at the bottom for the whole ad (joined with a lifestyle shot, say); the phone then also stays clear of the small print. |