请求

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

请求头为 Authorization: Bearer YOUR_API_KEY 和 Content-Type: application/json。示例使用后台模式;返回的 id 是 resp_...,请保存它。

参数说明

参数类型说明
modelstring必填,通义万相视频模型。
inputstring 或 array文本提示词,或包含 input_text/input_image 的 Responses 内容。
seconds / durationinteger视频时长;Wan 3.0 可用 -1 智能时长,其余模型按模型表中的限制填写。
resolution、ratiostring输出清晰度和比例,取值取决于模型。本接口不接受 21:9。
backgroundbooleantrue 表示创建后后台运行,推荐视频任务使用。
streambooleantrue 返回 SSE 进度;视频仍需任务完成后下载。
metadata.inputobjectWan 原生素材扩展,尤其是 Wan 3.0 / 2.7 的 media。
metadata.parametersobject原生生成参数,例如 prompt_extend、watermark、audio、seed;不要把它们直接放在 metadata 下。

参数类型、模型限制和默认值见完整模型表和原生参数说明。此处的 metadata 使用对象扩展参数,某些官方 SDK 只允许字符串标签,遇到 SDK 参数校验限制时使用本文的 HTTP 示例。

文生视频示例

curl --fail-with-body "https://top.qingyuntop.ai/v1/responses" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"wan2.7-t2v","input":"海边日落,镜头从沙滩缓慢推向远处灯塔。","seconds":5,"resolution":"720P","ratio":"16:9","background":true,"stream":false}'

图片和 Wan 3.0 媒体

Responses 图片内容示例:

{
  "model": "wan2.7-i2v",
  "input": [{"role":"user","content":[{"type":"input_text","text":"让画面中的云缓慢移动。"},{"type":"input_image","image_url":"https://example.com/start.png"}]}],
  "seconds": 5,
  "resolution": "720P",
  "background": true
}

Wan 3.0 参考图、参考视频和参考音频请使用 metadata.input.media,其 type 取 reference_image、reference_video 或 reference_audio。素材数量和组合限制与统一格式相同。