获取视频生成任务状态

Veo 视频生成任务状态查询 API：通过 task_id 跟踪从排队、生成到超采样完成的各阶段状态，获取视频公网下载链接，并附轮询频率、资源转存与失败处理建议。

(Veo 视频)

通过任务 ID 查询 Veo 视频生成的详细状态。当任务完成时，可在此获取视频的公网下载链接；生成过程中可通过状态字段跟踪任务所处阶段。

📌 基础信息

接口地址: GET /v1/video/generations/{task_id}
认证方式: Bearer Token (Authorization: Bearer {{YOUR_API_KEY}})
内容类型: application/json

📥 请求参数 (Path)

参数名	类型	必选	描述
task_id	`string`	是	创建任务时返回的 `task_id`。

📤 响应结果 (Response)

状态码: 200 OK

📝 请求示例 (cURL)

curl -X GET "https://anyrouter.win/v1/video/generations/task_LK8YADXPxyoGME6wv79x8qId62v76PO5" \
 -H "Authorization: Bearer $YOUR_API_KEY"

📝 返回示例 (任务完成)

{
  "code": "success",
  "message": "",
  "data": {
    "error": null,
    "format": "mp4",
    "metadata": null,
    "status": "succeeded", // 任务状态
    "task_id": "task_**",
    "url": "https://anyrouter.win/v1/videos/task_MQKsdsosLYRreob4Z4NzTFxZKtSoVRWZ/content" // 公网地址
  }
}

任务状态码

  VeoStatusPending = "pending"
  VeoStatusImageDownloading = "image_downloading"
  VeoStatusVideoGenerating = "video_generating"
  VeoStatusVideoGenerationCompleted = "video_generation_completed"
  VeoStatusVideoGenerationFailed = "video_generation_failed"
  VeoStatusVideoUpsampling = "video_upsampling"
  VeoStatusVideoUpsamplingCompleted = "video_upsampling_completed"
  VeoStatusVideoUpsamplingFailed = "video_upsampling_failed"
  VeoStatusCompleted = "completed"
  VeoStatusFailed = "failed"
  VeoStatusError = "error" // 错误（用于错误响应）

💡 开发者建议

轮询节奏: Veo 生成通常需要数分钟，建议以 5–10 秒的间隔轮询本接口，避免高频请求触发限流。任务从 pending 依次经过 image_downloading（图生视频场景）、video_generating 等阶段，直到 completed 或 failed。
超采样阶段: 部分任务在生成完成后会进入 video_upsampling（视频超采样）阶段以提升清晰度，此时视频尚不可下载，请等待状态变为 completed 再取 url。
资源及时转存: 返回的 url 是平台的公网代理地址（/v1/videos/{task_id}/content），建议任务成功后尽快将视频转存到自己的存储，不要依赖其长期有效。
失败处理: 状态为 failed / error 时，data.error 字段包含失败原因；图生视频场景下若源图片无法下载会在 image_downloading 阶段直接失败,建议校验图片 URL 的公网可达性后重试。

获取视频生成任务状态

On this page