两种返回方式
- 后台模式:
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 的视频模型。模型是否在你的账号分组中可用,以青云控制台实际显示为准。