Change a still image
update_stillChanges a long video's still image: its words (at, until; until null for the default length), placement, inset, side, fit, movement, focus or fade, with the same checks as add_still; a new asset_id, image_url or image_file replaces the picture. upload: true gives a fresh upload_url only for a still that is still waiting for its picture (a link that ran out); for a still that has its picture, add a new still instead. Free. Returns the same as add_still.
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": {
"project_id": "<project_id>",
"still_id": "<still_id>"
},
"name": "update_still"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | The word it appears on, { take_id, word } from get_transcript | |
| fit | No | auto (default) fills its box when that keeps three quarters of the image, else shows it whole over a blurred copy; fill crops; whole shows all of it | |
| fade | No | Seconds of fade in and out: 0 for a cut, or 0.1 to 0.5; default 0.3. A split doesn't fade | |
| move | No | in (a slow push from 100% to 110%), out, or none; default in, none for an inset | |
| side | No | ||
| focus | No | ||
| inset | No | ||
| until | No | The word it goes with; leave out (or null) for the default: the end of its sentence, at most 8 s | |
| upload | No | true: the person gives their own picture. The still is saved waiting, and you get upload_url for them (valid an hour). false is the same as leaving it out | |
| asset_id | No | An image in the brand kit (get_brand lists its asset ids): the project's kit, or brand_id's | |
| brand_id | No | The kit asset_id is in; default the project's | |
| still_id | Yes | From add_still or get_project | |
| image_url | No | A ClipLaunch image link (a generate_assets stored_url, a compose_asset URL, a get_brand view_url), or a public https image the person gave you or owns. Fetched once, now | |
| placement | No | full (default) covers the frame; screen fills the screen's box under the camera bubble; inset is a rounded 16:9 box in a corner; split halves the frame, the camera on one side and the still on the other (the screen recording isn't shown) | |
| at_seconds | No | Or the moment in the finished video (what review_render shows), turned into the word playing then | |
| image_file | No | ChatGPT only: the image the person attached, as a list of one. Leave out in other apps | |
| project_id | Yes | From create_project | |
| until_seconds | No | Or the moment in the finished video it goes, turned into the last word started by then |