查询视频任务

查询已提交的视频生成任务状态，并在任务完成后获取生成的视频地址。

接口地址

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

请求说明

通过任务 ID 查询视频生成任务的当前状态。响应中可能包含任务状态、生成后的视频链接、优化后的提示词以及状态更新时间。

查询参数

参数名	类型	必填	说明
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	生成完成后的视频 URL；如果任务尚未完成，则可能为 null。
enhanced_prompt	string	系统处理或增强后的提示词。
status_update_time	integer	任务状态最近更新时间，通常为毫秒级 Unix 时间戳。