Venice Video Retrieve / Status
venice_video_statusCheck a queued video job's status to return JSON progress or the completed video resource when processing finishes.
Instructions
Check status of a queued video job. Returns JSON progress while PROCESSING. Completed jobs are either an embedded base64 video/mp4 MCP resource or a download_url resource link. For VPS / Grok Imagine Private models, retrieve returns COMPLETED JSON without a URL: this process reuses the queue-time download_url when venice_video_generate ran here, or accepts a Venice-host download_url argument. POST endpoint with body {model, queue_id}. Supports x402 wallet auth (no Venice account needed) and API key.
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": {
"queue_id": "<queue_id>",
"model": "<model>"
},
"name": "venice_video_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | Yes | Same model id used to queue. | |
| queue_id | Yes | Returned by venice_video_generate. | |
| download_url | No | Queue-time download_url from venice_video_generate. Must be an https Venice host. Needed for VPS / Grok Imagine Private only when this process did not queue the job (retrieve returns COMPLETED without a URL). | |
| delete_media_on_completion | No | Delete server-side media after an embedded MP4 has been buffered, before the tool result returns to the client. Ignored for download_url results: download first, then call venice_video_complete. |