如何使用 Wan 3.0 全能参考 API:Omni Reference接入指南(2026)

2 min · 更新于 2026-07-11 · NamiFusion 团队

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 秒

💰 价格

分辨率计费公式
480P20 积分 × total_duration
720P40 积分 × total_duration
1080P80 积分 × total_duration

total_duration = 生成视频时长 + 参考视频的计费时长(多段参考视频按总时长累加)。

智能时长的计费方式:把 duration 设为 -1 时,成片长度由模型决定,下单时无法预知,因此按 30 秒上限计费。例如 1080P、智能时长、无参考视频输入,单次扣费 2400 积分。如果对时长有明确预期,直接填具体秒数会更省。

FAQ

可以先免费试用吗?+

注册赠送积分仅可用于指定模型,适用范围会持续更新;Playground 提交前会显示准确报价。

生成内容可以商用吗?有水印吗?+

可以商用,NamiFusion 不给生成结果加平台水印;使用须遵守服务条款与适用法律。

内容政策是什么?+

NamiFusion 是无过滤引擎,不做武断限制、对 NSFW 友好,但禁止违法内容与非自愿的真人素材,详见服务条款。

Wan 3.0 全能参考 的任务要跑多久?+

取决于参数,图像通常数秒到数十秒,视频通常数十秒到几分钟;API 返回 task_uuid 供轮询。

分辨率/时长上限是多少?+

以模型参数表为准:每个模型的可选分辨率、时长档位都在上方参数说明与 Playground 中列出。