API 参考AI 视频
Wan 3.0
Wan 3.0 在共用 AI 视频生成接口上的专属模型、限制与计费。
Wan 3.0 走共用的视频生成接口。接口本身、调用流程、输入内容、轮询、任务列表和错误码请看 AI 视频总览，本页只讲 Wan 3.0 的专属部分。
模型
| 模型 | 适用场景 | 限流 |
|---|---|---|
wan3.0-video | 最长 30 秒、原生同步出声的片段 | 5 RPM |
wan3.0-video-prime | 能力相同，端到端速度明显更快 | 5 RPM |
在 POST /v1/video-generation/generate 的 model 字段里传模型名。
限制
| 限制项 | Wan 3.0 与 Wan 3.0 Prime |
|---|---|
| 分辨率 | 480p、720p、1080p |
| 时长 | 2-30 秒，只接受整数秒 |
| 宽高比 | 16:9、4:3、1:1、3:4、9:16 |
| 提示词长度 | 最多 2500 字符 |
| 参考图 | 单次最多 9 张 |
inputVideoDuration | 1–15 秒，带参考视频时必填 |
两个模型都支持 first_frame 和 last_frame，其中 last_frame 必须与 first_frame 同时给。帧角色与 reference_image 不能在同一次请求里混用。音频为原生同步生成，generateAudio 默认 true——关掉它不会降低价格。给了首帧时，提示词可以不填。
Wan 3.0 不支持 21:9、4:5、5:4 宽高比，传了会返回
400。参考视频会占用时长预算：inputVideoDuration 与 duration
之和不能超过 30 秒，计费也按这个总秒数算。duration: -1（智能时长）不可用。Wan 3.0
的生成耗时也比其他系列长——480p 5 秒的片段实测约 5 分钟。
计费
积分随分辨率和时长增长，wan3.0-video-prime 在每一档都是标准版的 1.5 倍。总额向上取整到整数积分。
wan3.0-video：
| 分辨率 | 积分 / 秒 | 5 秒 | 10 秒 | 30 秒 |
|---|---|---|---|---|
480p | 5.625 | 29 | 57 | 169 |
720p | 11.25 | 57 | 113 | 338 |
1080p | 22.5 | 113 | 225 | 675 |
wan3.0-video-prime：
| 分辨率 | 积分 / 秒 | 5 秒 | 10 秒 | 30 秒 |
|---|---|---|---|---|
480p | 8.4375 | 43 | 85 | 254 |
720p | 16.875 | 85 | 169 | 507 |
1080p | 33.75 | 169 | 338 | 1013 |
生成前想拿准确数字，用 Wan 3.0 的 model、resolution、duration 调 POST /v1/video-generation/estimate-credits。积分在任务创建时扣除，失败自动退回。
示例
curl -X POST "https://api.marswave.ai/openapi/v1/video-generation/generate" \
-H "Authorization: Bearer $LISTENHUB_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan3.0-video",
"content": [
{ "type": "text", "text": "The camera pushes in slowly as the city lights come up" },
{ "type": "image_url", "role": "first_frame", "image_url": { "url": "https://example.com/open.jpg" } },
{ "type": "image_url", "role": "last_frame", "image_url": { "url": "https://example.com/close.jpg" } }
],
"resolution": "720p",
"ratio": "16:9",
"duration": 8,
"generateAudio": true
}'完整参数列表，以及文生视频、图生视频的请求结构，见 AI 视频总览。