查询任务与获取结果

请求端点

GET /v1/videos/{task_id}
Authorization: Bearer YOUR_API_KEY

将 {task_id} 替换为创建响应中的任务 ID。查询请求无需请求体。

cURL 示例

curl https://api.maomaotoken.com/v1/videos/task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx \
  -H "Authorization: Bearer YOUR_API_KEY"

成功响应

任务完成后，status 为 completed，使用 video_url 下载视频：

{
  "id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "object": "video",
  "model": "seedance2.0-Q-720p",
  "status": "completed",
  "progress": 100,
  "created_at": 1791000000,
  "completed_at": 1791000042,
  "video_url": "https://example.com/generated-video.mp4"
}

失败响应

任务失败时 status 为 failed，包含错误信息：

{
  "id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "object": "video",
  "status": "failed",
  "error": {
    "code": "invalid_prompt",
    "message": "提示词超过最大长度"
  }
}

详细的错误码说明见「错误码与处理方法」。

查询策略

建议每个视频任务每隔 10 秒发送一次 GET /v1/videos/{task_id}，查询任务状态，避免高频请求。

任务完成或失败后停止查询。

重要提示

不要使用高频轮询代替回调机制
video_url 可能有有效期，应在任务完成后尽快下载
查询超时不等于任务失败，应稍后重试