查询视频任务

查询指定视频生成任务的当前状态与结果。

请求

GET https://www.vortapapi.com/v1/video/query

查询参数

参数	类型	必填	说明
id	string	是	要查询的视频任务 ID。

请求头

名称	必填	说明
Content-Type	是	请求内容类型，通常为 application/json。
Accept	是	期望的响应格式，通常为 application/json。
Authorization	否	API 鉴权信息，例如 Bearer sk-***。
X-Forwarded-Host	否	转发请求时使用的原始主机信息。

请求示例

curl "https://www.vortapapi.com/v1/video/query?id=033fa60e-f37c-4ff6-a44d-5585ffea938d" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer sk-***"

响应示例

{
  "id": "033fa60e-f37c-4ff6-a44d-5585ffea938d",
  "status": "pending",
  "video_url": null,
  "enhanced_prompt": "```\nA surreal and whimsical digital painting of a majestic brown cow with large, feathered wings soaring gracefully through a vibrant blue sky. The cow has a joyful expression, its tail streaming behind it as it flies among fluffy white clouds. Below, a patchwork of green farmland stretches into the distance, with tiny farm buildings and a group of astonished farmers looking up in amazement. The scene is bathed in warm golden sunlight, creating a dreamlike and magical atmosphere. Art style inspired by fantasy illustrations with soft brushstrokes and rich, saturated colors.\n```",
  "status_update_time": 1750323167003
}

响应字段

字段	类型	说明
id	string	视频任务 ID。
status	string	任务状态，例如 pending 表示任务仍在处理中。
video_url	string | null	视频生成完成后返回的视频地址；未完成时通常为 null。
enhanced_prompt	string	系统优化后的提示词内容。
status_update_time	integer	状态更新时间，Unix 毫秒时间戳。