万相 2.7 图生视频使用 input.media 传入媒体素材,使用 parameters 设置输出参数。通过算无忧接入时,统一调用 POST /v1/videos。
支持的素材组合
| 任务 | media.type 组合 |
|---|
| 首帧生视频 | first_frame |
| 首帧 + 音频 | first_frame + driving_audio |
| 首尾帧生视频 | first_frame + last_frame |
| 首尾帧 + 音频 | first_frame + last_frame + driving_audio |
| 视频续写 | first_clip |
| 视频 + 尾帧续写 | first_clip + last_frame |
每种 type 在一次请求中最多出现一次。
首帧与音频驱动示例
curl --location --request POST \
'https://suanwuyou.com.cn/v1/videos' \
--header "Authorization: Bearer $SUANWYOU_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"model": "wan2.7-i2v",
"input": {
"prompt": "夜晚的城市铁路桥下,涂鸦角色从墙面跃出,配合音乐节奏做出有活力的说唱动作。",
"media": [
{
"type": "first_frame",
"url": "https://example.com/first-frame.png"
},
{
"type": "driving_audio",
"url": "https://example.com/driving-audio.mp3"
}
]
},
"parameters": {
"resolution": "720P",
"duration": 10,
"prompt_extend": true,
"watermark": false
}
}'
主要参数
| 字段 | 必选 | 说明 |
|---|
model | 是 | 算无忧模型 ID,当前使用 wan2.7-i2v |
input.prompt | 否 | 中英文提示词,上游官方限制为不超过 5000 个字符 |
input.negative_prompt | 否 | 不希望出现的内容,上游官方限制为不超过 500 个字符 |
input.media | 是 | 图像、音频或视频素材列表 |
parameters.resolution | 否 | 输出分辨率,例如 720P |
parameters.duration | 否 | 视频时长,需结合当前模型能力设置 |
parameters.prompt_extend | 否 | 是否扩写提示词 |
parameters.watermark | 否 | 是否添加水印 |
图片素材限制
上游官方文档对 first_frame 和 last_frame 的要求如下:
- 支持 JPEG、JPG、PNG(不支持透明通道)、BMP 和 WEBP。
- 宽、高均需在 240~8000 像素之间。
- 宽高比需在 1:8~8:1 之间。
- 单个图片文件不超过 20 MB。
- 支持可公网访问的 HTTP/HTTPS URL。
创建成功后保存 id 或 task_id,并调用 GET /v1/videos/{task_id} 查询结果。不要重复创建相同任务。