Wait for a video
wait_for_videoWaits up to max_seconds (default 50) for a video to finish, then returns it like get_video. Call again while status is queued or processing. While it waits, queue says why: plan_limit (the workspace already makes as many videos at once as its plan allows; position is its place in line) or render_capacity (every render machine is busy; estimated_wait_seconds is about how long) or generator_capacity (a music video: every music video generator is busy; position is its place in line). Tell the user.
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": {
"video_id": "<video_id>"
},
"name": "wait_for_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| video_id | Yes | The video id | |
| max_seconds | No | How long to wait (5–55, default 50) |