Put the real app on screen
place_screenPut the brand's real screenshot on the phone or tablet screen in a lifestyle still or clip. Generate the still with green_screen: true (its screen comes out plain green), then place_screen on the still, or on the clip animate_image makes from it: the screen is found and followed in every frame and the app stays sharp, with hands in front of the screen kept in front. Returns checks: a phone that rocks or shakes in the clip (animate again), app text too small to read, frames where the screen was lost. 5 credits. A still comes back straight away; a clip returns a task_id at once, so follow with get_task.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "place_screen"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| image | No | Or a still: stored path (assets/..., uploads/...) or public https | |
| video | No | Or a clip: stored path or public https MP4 | |
| corners | No | Stills only: the screen's corners as fractions of the image (top-left, top-right, bottom-right, bottom-left), when it isn't green | |
| asset_id | No | The screenshot to show, from the brand kit. With brand_id and no asset_id or screenshot, 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. | |
| job_token | No | A finished image or video job_token (generate_assets with green_screen, or animate_image of that still) | |
| screenshot | No | Or a stored or public https screenshot | |
| 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. |