APIMaster.ai

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,然后修正请求;不要把受理当作成功