match_scene_motion
Match a scene's source motion
Cut the stretch of source video a scene was read from, so a clip model can be shown the original's camera and timing. Only a scene born from an analysed video has a source; any other scene is refused, and the refusal says so. Spends no credits and changes nothing on the board: the answer is a clip generation to pass as reference_videos on animate_scenes for that scene. get_generation waits until it is ready.
Scope
storyboards.write— Authors, edits, renders and deletes storyboards. Reading a board rides media.read, and the two board tools that spend need generation.write as well.
Behaviour
- Writes
- Creates or changes items in the caller's own account.
- Can delete or overwrite
- Can delete, overwrite, cancel or withdraw something the caller already has, so a host should confirm it.
- Stays in the account
- Stays inside the caller's private Kuro account: any media provider it calls acts on Kuro's account, and the result is visible to no one else.
Credits
What the tool's description says about credits, verbatim.
- Spends no credits and changes nothing on the board: the answer is a clip generation to pass as `reference_videos` on animate_scenes for that scene. get_generation waits until it is ready.
Inputs
storyboard_idstring · requireduuid
sceneinteger · required> 0
Example call
A tools/call request with the required arguments only, each a placeholder read off the schema. Replace them before sending.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "match_scene_motion",
"arguments": {
"storyboard_id": "00000000-0000-4000-8000-000000000000",
"scene": 1
}
}
}Input schema
As the server sends it in tools/list.
{
"type": "object",
"properties": {
"storyboard_id": {
"type": "string",
"format": "uuid"
},
"scene": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"required": [
"storyboard_id",
"scene"
],
"additionalProperties": false
}Related tools
- animate_scenes
Film the scenes you name, or every scene whose still is ready and whose clip is not.
- get_generation
Get current status and signed media URL for one generation.