Wan 3 EP

使用异步视频接口。本章描述 wan3.0-video-ep，不要与其他分组中的 wan-3-0 系列混淆。

输出与基础单价

模型 ID	分辨率	基础单价（美元 / 计费秒）
`wan3.0-video-ep`	`480p`	0.05
`wan3.0-video-ep`	`720p`	0.10
`wan3.0-video-ep`	`1080p`	0.20

实际优惠价以模型广场及 Key 分组为准，表格不是固定成交价承诺。

输出 duration 支持 2–30 的任意整数，例如 7 秒、12 秒。
比例：adaptive、16:9、4:3、1:1、3:4、9:16。
audio：是否生成声音。
prompt_extend：是否优化 / 扩展提示词；建议明确传 false 或 true。
seed：可选，范围 0–2147483647；省略表示随机，不使用 -1。

文生视频

{
  "model": "wan3.0-video-ep",
  "prompt": "A paper boat drifting across a quiet lake, cinematic lighting.",
  "mode": "text",
  "duration": 7,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "audio": true,
  "prompt_extend": false
}

首尾帧

{
  "model": "wan3.0-video-ep",
  "prompt": "A smooth transition from the first image to the final image.",
  "mode": "first_last_frame",
  "first_frame_url": "https://example.com/first.png",
  "last_frame_url": "https://example.com/last.png",
  "duration": 8,
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "audio": true
}

至少提供首帧或尾帧之一；仅一帧时保留对应字段即可。不要同时传入参考视频或参考音频。

全能参考

{
  "model": "wan3.0-video-ep",
  "prompt": "Animate the character in image 1, following the camera motion in video 1.",
  "mode": "multi_ref",
  "image_urls": [
    "https://example.com/character.png"
  ],
  "reference_video_urls": [
    "https://example.com/motion.mp4"
  ],
  "duration": 12,
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "audio": true,
  "prompt_extend": false
}

最多 10 张图片、5 段视频、5 段音频。音频参考至少搭配一张图片或一段视频，不支持仅音频。

参考限制

媒体	规格
图片	JPEG / JPG、PNG、BMP、WebP；单边 240–8000px；最长边 / 最短边 ≤ 8；每张 ≤ 20MB
视频	MP4 / MOV；单边 240–4096px；最长边 / 最短边 ≤ 8；帧率 ≥ 16fps；每段 ≤ 100MB
音频	MP3 / WAV；每段 ≤ 15MB

PNG 可以上传，但不要使用透明通道作为预期有效输入，必要时先合成不透明背景。

视频与音频：每段 1–15 秒，同类分别累计 ≤ 15 秒。Wan EP 没有沿用 Seedance 的 0.2 秒余量。

含参考视频时还有一条独立约束：

参考视频总时长 + 输出时长 ≤ 30 秒

例如参考视频合计 12.5 秒，输出 17 秒可以；输出 18 秒不可以。服务端会读取真实媒体信息，不以客户端填写的时长代替。

怎么计费

计费秒数 = 输出时长 + 参考视频总时长
基础金额 = 当前分辨率单价 × 计费秒数

没有参考视频时只计算输出时长。参考音频不增加计费秒数。

例如标准版 720p，8 秒参考视频、12 秒输出：基础金额为 0.10 × (8 + 12) = $2.00，再按当前 Key 适用价格结算。不要因为输出只有 12 秒而漏算输入视频费用。

获取结果

查询 GET /v1/video/generations/{task_id}，终态成功时读取 metadata.url。任务生成结束后还可能需要处理结果文件，这段时间仍请按 status 继续等待，而不是重新提交。