查询任务与结果¶

推荐查询路径¶

GEThttps://ai.shanhui.tv/v1/video/generations/{task_id}

curl -sS 'https://ai.shanhui.tv/v1/video/generations/task_xxxx' \
  -H 'Authorization: Bearer sk-your-api-key'

兼容查询路径¶

GEThttps://ai.shanhui.tv/v1/videos/{task_id}

该路径按 OpenAI 视频任务风格返回状态，可用于已有的 /v1/videos/{id} 客户端。新项目建议提交与查询都使用 /v1/video/generations 这一组配对路径，减少响应结构判断。

状态说明¶

`status`	含义	调用方处理
`queued`	已接收，等待调度	继续轮询
`in_progress`	正在生成	继续轮询，建议间隔 8–15 秒
`completed`	已完成	读取并保存结果 URL
`failed`	失败	读取 `error`，修正后重新提交

生成中响应¶

{
  "id": "task_xxxx",
  "task_id": "task_xxxx",
  "object": "video",
  "model": "doubao-seedance-2-0-fast-260128",
  "status": "in_progress",
  "progress": 50,
  "created_at": 1781001293
}

完成响应¶

{
  "id": "task_xxxx",
  "task_id": "task_xxxx",
  "object": "video",
  "model": "doubao-seedance-2-0-fast-260128",
  "status": "completed",
  "progress": 100,
  "created_at": 1781001293,
  "completed_at": 1781001450,
  "metadata": {
    "url": "https://example-cdn.com/output.mp4?signature=..."
  }
}

结果 URL 会过期

视频 URL 通常是带签名的临时地址，常见有效期约 24 小时。完成后应尽快下载或转存到自己的对象存储，不要把临时 URL 当作永久资源地址。

失败响应¶

{
  "id": "task_xxxx",
  "status": "failed",
  "progress": 100,
  "error": {
    "code": "InputImageSensitiveContentDetected.PrivacyInformation",
    "message": "The request failed because the reference image was rejected."
  }
}

轮询达到业务超时后不要重复提交相同任务。先保留 task_id 并继续低频查询，避免同时产生多个计费任务。