Wan 3.0 视频 API
APIMaster 上 wan3.0-video 的参数、媒体组合、异步任务、下载和按秒计费。
Wan 3.0 视频 API
wan3.0-video 是标准的 Wan 3 模型;它与 wan3.0-video-prime 是独立的模型。它支持文本、图像、视频、音频、文档和公开网页。每个成功的任务生成一个 MP4/H.264 视频,最长 30 秒。集成审查日期:2026-11-17。
每个请求最多包含 20 项媒体素材;生成视频的帧率为 30 fps。
端点与认证
| 操作 | 端点 |
|---|---|
| 创建 | POST https://apimaster.ai/v1/videos |
| 查询 | GET https://apimaster.ai/v1/videos/{task_id} |
| 下载 | GET https://apimaster.ai/v1/videos/{task_id}/content |
Authorization: Bearer YOUR_API_KEY · Content-Type: application/json
所有请求参数
同一请求请选择一种媒体格式。用 metadata.input.media 提交混合参考素材或文档。
| 参数 | 类型 | 必填 / 默认值 | 含义与有效值 |
|---|---|---|---|
model |
string | 必填 | 必须为 wan3.0-video;不要替换为 Prime |
prompt |
string | 必填 | 用中文或英文描述结果;官方限制为 20,000 个字符,更长的原生文本会被截断。按媒体顺序引用 Image 1、Video 1、Audio 1;每种媒体类型有各自的编号 |
duration |
integer | 5 |
输出时长为 2–30 秒;-1 让模型选择时长。使用参考视频时,输入加输出时长不能超过 30 秒 |
seconds |
string | 可选 | 时长别名,例如 "5" 或 "-1";两者都提供时必须与 duration 一致 |
resolution |
string | 1080P |
480P、720P、1080P;顶层小写值会被规范化 |
aspect_ratio |
string | adaptive |
adaptive、21:9、16:9、4:3、1:1、3:4、9:16 |
ratio |
string | 可选 | aspect_ratio 的别名;视频扩展建议使用 adaptive |
size |
string | 可选 | 兼容性别名:分辨率档位,或受支持的像素映射,例如 1280x720;优先使用明确的 resolution 和 ratio,而非任意像素尺寸 |
generate_audio |
boolean | 上游默认 true |
输出是否包含音轨。显式 false 会被保留。音频不会改变每秒费率 |
audio |
boolean | 可选 | generate_audio 的别名;只使用一个音频开关 |
prompt_extend |
boolean | true |
智能提示词重写;显式 false 会被保留。文档/页面输入时必须为 true |
watermark |
boolean | 上游默认 false |
为输出添加水印;显式 false 会被保留 |
seed |
integer | 随机 | -1 或 0–2147483647。省略或 -1 表示请求随机种子;0 会被转发。重复的种子不保证输出完全相同 |
input_reference |
string | 可选 | 首帧图像 URL;会替换原生媒体数组。不要混用输入风格 |
images |
string[] | 可选 | 当 input_reference 不存在时,作为 reference_image 项追加的便捷数组 |
metadata |
object | 可选 | 下方原生对象的容器;不能更改所选模型 |
metadata.input |
object | 可选 | 原生 input 对象 |
metadata.input.prompt |
string | 可选 | 原生提示词覆盖;保留必需的顶层 prompt |
metadata.input.media |
object[] | 可选 | 有序媒体数组。每项都需要 type 和 url;参见下方限制 |
metadata.input.media[].type |
string | 每项必填 | first_frame、last_frame、reference_image、reference_video、reference_audio、file、link |
metadata.input.media[].url |
string | 每项必填 | 公开的 HTTP(S) 媒体 URL;图像类型也接受 data:{MIME_type};base64,... 字符串。非图像媒体需要公开 URL |
metadata.parameters |
object | 可选 | 原生参数对象;不能为 null |
metadata.parameters.resolution |
string | 1080P |
大写 480P、720P、1080P |
metadata.parameters.ratio |
string | adaptive |
与上方列出的相同宽高比值 |
metadata.parameters.duration |
integer | 5 |
2–30,或 -1;同样受组合时长约束 |
metadata.parameters.audio |
boolean | 上游默认 true |
相同的输出音频开关 |
metadata.parameters.prompt_extend |
boolean | true |
相同的提示词重写开关;file/link 要求为 true |
metadata.parameters.watermark |
boolean | 上游默认 false |
相同的水印开关 |
metadata.parameters.seed |
integer | 随机 | 相同的种子范围,包括显式 0 |
原生 negative_prompt、img_url、first_frame_url、last_frame_url 和 audio_url 字段不是 Wan 3 的媒体控制项。请改用文档中描述的媒体数组。
媒体限制与有效组合
| 媒体类型 | 数量与限制 |
|---|---|
first_frame、last_frame |
每种最多一个。尾帧需要首帧。帧控制不能与任何参考、文件或链接类型组合 |
reference_image |
最多 10 个。JPEG/JPG、无透明度的 PNG、BMP 或 WEBP;每边 240–8,000 像素,宽高比至多 8:1,每个文件至多 20 MB |
reference_video |
最多 5 个 MP4/MOV 片段;每个 1–15 秒,组合输入至多 15 秒;至少 16 fps;每边 240–4,096 像素,宽高比至多 8:1,每个文件至多 100 MB |
reference_audio |
最多 5 个 WAV/MP3 片段;每个 1–15 秒,组合时长至多 15 秒;每个文件至多 15 MB |
file |
最多一个 DOCX/DOC/XLSX/XLS/PPTX/PPT/PDF/TXT/KEY/PAGES/NUMBERS/MD 文件;最多 100 MB。PDF、DOCX、DOC、PPTX、PPT 和 KEY/PAGES 分页文档有 50 页限制 |
link |
最多一个无需登录即可公开访问的页面;不要与 file 组合 |
参考图像、视频和音频可以组合使用。文件或链接可与参考媒体一同提供。首/尾帧模式仅接受帧控制;音频驱动生成请使用参考图像加参考音频模式。媒体解析和内容审核仍受上游检查约束。
文生视频使用不带媒体的提示词。首帧动画使用 first_frame;转场使用 first_frame 加 last_frame。参考生成使用参考类型。对于编辑或扩展,提供 reference_video,并在提示词中描述编辑或扩展;扩展时使用 adaptive。
示例
文本生成视频
curl "https://apimaster.ai/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"wan3.0-video","prompt":"A paper boat drifting on a quiet pond, static camera.","duration":2,"resolution":"480P","aspect_ratio":"16:9","generate_audio":false,"prompt_extend":false,"watermark":false,"seed":0}'
首帧和尾帧
{"model":"wan3.0-video","prompt":"Move smoothly from the first frame to the last.","duration":5,"resolution":"720P","metadata":{"input":{"media":[{"type":"first_frame","url":"https://example.com/start.png"},{"type":"last_frame","url":"https://example.com/end.png"}]}}}
参考图像和音频
{"model":"wan3.0-video","prompt":"Animate Image 1 to the rhythm of Audio 1.","duration":5,"resolution":"720P","metadata":{"input":{"media":[{"type":"reference_image","url":"https://example.com/character.png"},{"type":"reference_audio","url":"https://example.com/music.mp3"}]}}}
视频编辑 / 续写与智能时长
{"model":"wan3.0-video","prompt":"Extend Video 1 forward as the camera follows the paper boat.","duration":-1,"resolution":"480P","aspect_ratio":"adaptive","metadata":{"input":{"media":[{"type":"reference_video","url":"https://example.com/input.mp4"}]}}}
文档 / 网页
{"model":"wan3.0-video","prompt":"Create a product introduction based on this document.","duration":10,"resolution":"720P","prompt_extend":true,"metadata":{"input":{"media":[{"type":"file","url":"https://example.com/product.pdf"}]}}}
请将所有示例 URL 替换为真实的公开媒体地址。对于网页输入,请将文件项替换为 {"type":"link","url":"https://example.com/product"}。首帧示例在不包含尾帧项时同样有效。
响应、轮询、下载与日志
创建操作返回的是 APIMaster 任务 ID,而非上游 ID:
{"id":"task_example","task_id":"task_example","object":"video","model":"wan3.0-video","status":"queued"}
| 响应字段 | 含义 |
|---|---|
id / task_id |
平台任务标识符,用于查询和下载 |
status |
queued、in_progress、completed、failed |
progress |
进度指示;请等待至终态 |
error.code、error.message |
适用时的失败信息 |
metadata.url |
完成时返回的内容位置 |
请使用同一 API key 每隔约 15 秒轮询一次。请勿为检查进度而另外创建任务。原生提供商的任务 ID 和输出 URL 在 24 小时后过期;请及时下载并保留成功的结果。优先使用 APIMaster 的经过身份验证的内容端点,而非存储临时上游 URL。
curl "https://apimaster.ai/v1/videos/task_example" -H "Authorization: Bearer YOUR_API_KEY"
curl -L "https://apimaster.ai/v1/videos/task_example/content" \
-H "Authorization: Bearer YOUR_API_KEY" -o wan3.mp4
使用日志包含该任务及成功的视频结果。请在完成后检查最终扣费;受理并不代表生成成功。重复轮询不会产生额外的生成费用。
计费
每秒费率请查看模型卡片。
APIMaster 把所有输入视频时长与输出视频时长相加,合计向上取整一次,再乘以所选输出分辨率的每秒费率。输入 2.3 秒、输出 5 秒,按 8 秒收费。没有输入视频时只计输出秒数。参考视频请求无需询价或填写输入时长。生成失败会退回预扣,最终金额可在使用日志查看。
错误与修正
| 现象 | 修正方法 |
|---|---|
| 时长/分辨率/比例无效 | 使用上述枚举和取值范围;智能时长恰好为 -1 |
| 帧/参考冲突,只有尾帧而没有首帧 | 遵循组合规则 |
| 文件/链接且重写被禁用 | 设置 prompt_extend:true |
| 媒体获取/格式/时长失败 | 使用满足所有大小、格式和时长限制的公开文件 |
| 缺少 prompt | 为 APIMaster API 保留非空的顶层 prompt |
| 任务失败或被审核 | 检查 error,然后修正请求;不要把受理当作成功 |
