跳到主要内容

异步任务与错误处理

异步任务流程​

视频生成（以及传 async: true 的图片生成）都是异步任务：

  1. 提交任务：调用提交接口（如 POST /v1/videos），返回任务对象，包含 id / task_id 和 status。
  2. 查询任务：轮询查询接口（如 GET /v1/videos/{task_id}），直到 status 为完成或失败。建议间隔 5–10 秒。
  3. 下载结果：完成后调用下载接口（如 GET /v1/videos/{task_id}/content）或使用返回中的结果 URL。

每个模型的提交、查询、下载接口及字段说明见左侧「视频类」各厂商目录。

鉴权失败​

  • 返回 401：检查请求头是否为 Authorization: Bearer sk-xxx，Key 是否完整、是否已被禁用。
  • 不要把 Bearer 重复写两次，也不要在 Key 前后留空格。

参考素材​

图生图、图生视频需要的参考图可以先用 文件上传接口（POST /v1/files/upload） 接口上传，再把返回的 URL 传给模型接口；也可以直接传公网 URL 或 Data URL（以各接口说明为准）。