如何使用 Wan 3.0 全能参考 API:Omni Reference接入指南(2026)
Wan 3.0 全能参考 API 接入教程:参数说明、价格与可直接运行的调用代码,先在 Playground 试玩再一行代码接入。
Wan 3.0 全能参考 是一款Omni Reference模型(由 Alibaba 提供):支持图片、视频、音频、文档、网页多模态参考输入,单次生成最长 30 秒、原生带音轨的视频。像素级还原参考素材中的角色、道具与空间关系,并支持首尾帧模式进行精确控制。在 NamiFusion 上可以在 Playground 直接试玩(提交前显示准确报价),再通过统一 REST API 一行代码接入,典型一次调用约 $1.00。
TL;DR
· 任务类型:Omni Reference,由 Alibaba 提供
· 价格:典型一次约 $1.00($1 = 100 积分),按量计费无订阅
· 上手路径:Playground 试玩(提交前显示报价)→ API Keys 建密钥 → 一个 POST 接入
· 可调参数:12 个(见下方参数表)
· 无平台水印,商用可用(遵守服务条款)
用 Wan 3.0 全能参考 能做什么?
内容生产自动化:把该模型接入你的工作流,用统一 API 按量调用。
怎么调用这个 API?
1. 在 NamiFusion 注册并在 API Keys 页面创建密钥(注册赠送积分仅可用于指定模型)。
2. 用下面的 cURL 示例提交任务,Header 带上 Bearer 密钥。
3. 用返回的 task_uuid 轮询任务状态,完成后取输出 URL。
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/alibaba/wan-3.0/video" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"resolution": "1080P",
"aspect_ratio": "adaptive",
"duration": 5,
"generate_audio": true,
"enable_thinking": false
}
}'
# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
-H "Authorization: Bearer YOUR_API_KEY"有哪些参数?
prompt(提示词):可选
images(参考图片):可选
audios(参考音频):可选
first_frame(首帧):可选
last_frame(尾帧):可选
resolution(分辨率):可选,默认 "1080P"
aspect_ratio(长宽比):可选,默认 "adaptive"
duration(生成时长(秒)):可选,默认 5
generate_audio(生成音轨):可选,默认 true
enable_thinking(深度思考模式):可选,默认 false
file(参考文档):可选
link(参考网页):可选
Wan 3.0 全能参考 的提示词怎么写?
1. 主体在前:先写画面主角与动作,再补环境、光线、风格("一名宇航员在雨中的霓虹街头奔跑,电影感,浅景深")。
2. 用具体名词代替形容词堆砌:"85mm 人像镜头、黄昏逆光" 比 "非常好看、超高质量" 有效得多。
3. 迭代时只改一个变量:固定 seed 复现结果,每次只调整一个描述词,才能知道是什么在起作用。
4. 负面信息放正面写:与其说"不要模糊",不如直接要"锐利对焦、清晰细节"。
价格是多少?
按次积分计价,典型一次调用约 $1.00($1 = 100 积分),实际价格随参数(分辨率/时长等)变化,Playground 里提交前会显示准确报价。
Wan 3.0 全能参考
一次调用,把图片、视频、音频、文档、网页变成同一条视频
Alibaba Wan 3.0 Omni Reference 支持五类参考输入同时生效,单次生成最长 30 秒、原生带音轨的视频。它在像素级还原参考素材中的角色、道具与空间关系的同时,支持首尾帧模式做精确控制,也可以把成片长度交给模型自行决定。开箱即用的 REST 推理 API,无冷启动。
🚀 主要功能
- 五类参考输入:最多 10 张参考图、5 段参考视频、5 段参考音频,外加 1 份参考文档或 1 个网页链接,可自由组合。
- 像素级身份保持:角色、道具、服装与空间关系在新镜头中保持一致,无需额外训练。
- 原生音轨:默认直接输出带声音的视频,省掉单独的配音环节。
- 首尾帧控制:指定首帧、尾帧或两者,精确约束镜头的起止画面。
- 智能时长:把时长交给模型,由内容自行决定成片长度(最长 30 秒)。
- 深度思考模式:开启后可解析参考文档、网页与复杂图像内容,再据此生成。
🛠️ 技术规格
| 参数 | 说明 |
|---|---|
| 模型架构 | Alibaba Wan 3.0 |
| 参考图片 | 最多 10 张 |
| 参考视频 | 最多 5 段(时长计入计费) |
| 参考音频 | 最多 5 段 |
| 参考文档 / 网页 | 文档 ≤100MB、≤50 页,或 1 个公开网页;二选一,需开启深度思考模式 |
| 输出格式 | 视频(MP4,默认含音轨) |
| 分辨率 | 480P / 720P / 1080P(默认 1080P) |
| 宽高比 | adaptive / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 |
| 时长 | 2–30 秒(默认 5 秒),或设为 -1 交由模型决定;有视频输入时,输入与输出总时长不超过 30 秒 |
| 超时 | 300 秒 |
💰 价格
| 分辨率 | 计费公式 |
|---|---|
| 480P | 20 积分 × total_duration |
| 720P | 40 积分 × total_duration |
| 1080P | 80 积分 × total_duration |
total_duration = 生成视频时长 + 参考视频的计费时长(多段参考视频按总时长累加)。
智能时长的计费方式:把 duration 设为 -1 时,成片长度由模型决定,下单时无法预知,因此按 30 秒上限计费。例如 1080P、智能时长、无参考视频输入,单次扣费 2400 积分。如果对时长有明确预期,直接填具体秒数会更省。
FAQ
可以先免费试用吗?+
注册赠送积分仅可用于指定模型,适用范围会持续更新;Playground 提交前会显示准确报价。
生成内容可以商用吗?有水印吗?+
可以商用,NamiFusion 不给生成结果加平台水印;使用须遵守服务条款与适用法律。
内容政策是什么?+
NamiFusion 是无过滤引擎,不做武断限制、对 NSFW 友好,但禁止违法内容与非自愿的真人素材,详见服务条款。
Wan 3.0 全能参考 的任务要跑多久?+
取决于参数,图像通常数秒到数十秒,视频通常数十秒到几分钟;API 返回 task_uuid 供轮询。
分辨率/时长上限是多少?+
以模型参数表为准:每个模型的可选分辨率、时长档位都在上方参数说明与 Playground 中列出。