Wait for Video Project
wait_for_video_projectPolls an existing video project until it completes, fails, is canceled, or times out. Read-only. After a timeout, use the same project ID to resume checking. Use signed download URLs unchanged. In ChatGPT, show Magic Hour's result card for playback and download when the video completes.
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": "wait_for_video_project"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Existing project ID returned by the matching creation tool. Reuse this ID after a wait timeout. | |
| timeout_seconds | No | Maximum seconds for this wait call, finite and greater than zero. Timeout does not cancel the project or start another generation. | |
| max_inline_downloads | No | Reserved for compatibility. Video waits do not inline downloads; leave at zero. | |
| poll_interval_seconds | No | Seconds between status checks. Must be finite and nonnegative; values below 0.5 use 0.5 seconds. | |
| include_inline_downloads | No | Reserved for compatibility. Video waits return download links, never inline video, regardless of this value. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Existing project identifier, retained for subsequent status checks. | |
| status | No | Project status such as complete, error or canceled; timeout means only this wait call ended. | |
| message | No | Wait timeout or recovery guidance, when present. | |
| downloads | No | Available output files with exact signed URLs. May be absent until completion. | |
| last_project | No | Last observed API project snapshot if the wait timed out after a successful status check. | |
| project_type | Yes | Kind of project being retrieved. | |
| exact_download_urls | No | Convenience list of the same unmodified signed output URLs. | |
| download_expiration_metadata | No | Expiration metadata only. Never append it to a download URL. |