请求
POST https://top.qingyuntop.ai/v1/responses
请求头为 Authorization: Bearer YOUR_API_KEY 和 Content-Type: application/json。示例使用后台模式;返回的 id 是 resp_...,请保存它。
参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
model | string | 必填,通义万相视频模型。 |
input | string 或 array | 文本提示词,或包含 input_text/input_image 的 Responses 内容。 |
seconds / duration | integer | 视频时长;Wan 3.0 可用 -1 智能时长,其余模型按模型表中的限制填写。 |
resolution、ratio | string | 输出清晰度和比例,取值取决于模型。本接口不接受 21:9。 |
background | boolean | true 表示创建后后台运行,推荐视频任务使用。 |
stream | boolean | true 返回 SSE 进度;视频仍需任务完成后下载。 |
metadata.input | object | Wan 原生素材扩展,尤其是 Wan 3.0 / 2.7 的 media。 |
metadata.parameters | object | 原生生成参数,例如 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。素材数量和组合限制与统一格式相同。