查询任务

我会将这段参考改写为 Vortap 风格的原创中文 Markdown，保留接口事实与字段结构，并替换品牌、域名和示例密钥信息。# 查询视频任务

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

通过任务 ID 查询视频生成任务的当前状态。接口会返回任务状态、生成结果地址以及与任务相关的提示词信息。

请求方式

GET /v1/video/query

查询参数

名称	类型	必填	说明
id	string	是	需要查询的视频任务 ID。

请求头

名称	必填	说明
Content-Type	是	请求内容类型，通常为 application/json。
Accept	是	期望接收的响应格式，通常为 application/json。
Authorization	否	API 认证信息，格式通常为 Bearer sk-***。
X-Forwarded-Host	否	可选转发主机信息。

请求示例

curl -X GET "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 时间戳。