两种返回方式

  • 后台模式:background: true,POST 很快返回 resp_...,随后 GET 查询。
  • 同步或 SSE 模式:background: false;stream: true 时收到进度和完成事件。SSE 是任务观察流,不是视频文件流。

无论哪种模式,最终都要从响应的 metadata.task_id 取得视频任务 ID,再调用 /v1/videos/{task_id}/content。

鉴权和地址

Authorization: Bearer YOUR_API_KEY

创建:POST https://top.qingyuntop.ai/v1/responses

查询:GET https://top.qingyuntop.ai/v1/responses/{response_id}

下载:GET https://top.qingyuntop.ai/v1/videos/{task_id}/content

输入模型

最简单的文生视频把 input 写成字符串。需要图像时,可以使用 Responses 的 input_text 和 input_image;分别填写提示词和图片地址。Wan 3.0 的完整参考媒体仍可放入 metadata.input.media。

可用模型

Responses 与统一格式共用通义万相视频模型范围:Wan 3.0、Wan 2.7、Wan 2.6、Wan 2.5、Wan 2.2 和 WanX 2.1 的视频模型。模型是否在你的账号分组中可用,以青云控制台实际显示为准。

参阅完整模型表,再按创建任务和查询下载接入。