查询视频任务

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

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

说明

通过任务 ID 获取视频生成任务的执行进度。任务完成后，响应中会返回生成的视频地址；如果任务仍在处理中，video_url 通常为 null。

查询参数

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

请求头

名称	必填	说明
Content-Type	是	请求内容类型，通常为 application/json。
Accept	是	期望的响应格式，通常为 application/json。
Authorization	否	API Key，格式为 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	string	视频任务 ID。
status	string	任务状态，例如 pending、completed、failed 等。
video_url	string | null	生成完成后的视频 URL；未完成时为 null。
enhanced_prompt	string	系统增强后的提示词内容。
status_update_time	integer	状态最近更新时间，Unix 毫秒时间戳。

响应示例

{
  "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
}