任务与错误

视频和部分图片生成采用异步任务；语音接口通常同步返回音频。

视频任务状态

轮询建议

创建视频任务后，客户端用返回的 id 查询：

GET /v1/videos/{task_id}

每 60 秒查询一次；应用回到前台或网络恢复后可立即查询。completed 表示成功，failed 表示失败，看到这两个状态后就停止查询。提高查询频率不会加快任务完成。

如果你有自己的服务器，还可以在创建任务时填写 callbackUrl：任务完成或失败后，平台会主动通知这个地址。没有自己的服务器时，可以省略。设置方法和通知示例见视频生成。

成功后，优先使用查询结果中的 url 获取视频。如需通过平台下载视频文件，使用：

GET /v1/videos/{task_id}/content

/content 会传输视频文件，只在确认完成后调用，不要用它轮询状态。

错误响应

本平台错误响应兼容 OpenAI 风格：

{
  "error": {
    "message": "image input is required",
    "type": "invalid_request_error",
    "code": "invalid_request"
  }
}

视频任务失败时，任务对象里也可能包含错误：

{
  "id": "task_xxx",
  "object": "video",
  "status": "failed",
  "error": {
    "message": "upstream task failed",
    "code": "task_failed"
  }
}

常见 400 场景