Get a video
get_videoGet the status and details of one video the caller owns, by id. While rendering, status is PENDING/GENERATING_*/RENDERING and estimatedCompletionTime (seconds) is returned. When status is COMPLETED, a playable videoUrl and thumbnailUrl are returned; when FAILED, error says why, and a failure for lack of credits adds blockedReason "INSUFFICIENT_CREDITS" with creditsNeeded, creditsAvailable and topUpUrl (it will not be retried: top up and create the video again). Requires the "video:read" scope. Read-only, never charges credits. Also polls a motion clip made by generate_motion_clip: the answer then has kind "motion_clip", the promptSent, and on FAILED an errorCode and creditsRefunded.
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": {
"id": "<id>"
},
"name": "get_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The video id returned by create_video or list_videos. |