如何使用 Vidu Q4 Preview 图生视频 API：图生视频接入指南（2026）

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

Vidu Q4 Preview 图生视频 API 接入教程：参数说明、价格与可直接运行的调用代码，先在 Playground 试玩再一行代码接入。

Vidu Q4 Preview 图生视频是一款图生视频模型（由 Vidu 提供）：根据提示词和单张图片生成 3～16 秒视频，支持可选音频和提示词扩展，以及 540p、720p、1080p、2k、4k 分辨率。在 NamiFusion 上可以在 Playground 直接试玩（提交前显示准确报价），再通过统一 REST API 一行代码接入，典型一次调用约 $0.475。

TL;DR

· 任务类型：图生视频，由 Vidu 提供

· 价格：典型一次调用约 $0.475（$1 = 100 积分），按量计费无订阅

· 上手路径：Playground 试玩（提交前显示报价）→ API Keys 建密钥 → 一个 POST 接入

· 可调参数：7 个（见下方参数表）

· 无平台水印，商用可用（遵守服务条款）

用 Vidu Q4 Preview 图生视频能做什么？

短视频与广告片段：从一句话或一张图直接产出可发布的动态素材。

产品演示与概念预览：低成本验证分镜和视觉方向，再决定是否实拍。

社媒内容工厂：批量生成竖屏短片，配合热点话题快速上线。

已有素材的二次创作：图生视频让静态作品动起来，延长内容生命周期。

怎么调用这个 API？

在 NamiFusion 注册并在 API Keys 页面创建密钥（注册赠送积分仅可用于指定模型）。
用下面的 cURL 示例提交任务，Header 带上 Bearer 密钥。
用返回的 task_uuid 轮询任务状态，完成后取输出 URL。

提交任务

# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/vidu/q4-preview/image-to-video" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "prompt": "A sleek luxury perfume bottle on a glossy black pedestal slowly rotates as soft golden light sweeps across the glass, revealing elegant reflections and floating particles in the air. The camera performs a smooth cinematic push-in with subtle parallax, creating a premium advertising look. High detail, refined motion, realistic lighting, polished product-commercial style.",
    "image": [
      "https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/10/09/7598f96abcb7.jpeg"
    ],
    "resolution": "720p",
    "duration": 5,
    "enable_prompt_expansion": false,
    "generate_audio": true,
    "seed": -1
  }
}'

# 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（提示词）：必填

image（图片）：必填

resolution（分辨率）：可选，默认 "720p"

duration（时长）：可选，默认 5

enable_prompt_expansion（启用提示词扩写）：可选，默认 false

generate_audio（生成音频）：可选，默认 true

seed（随机种子）：可选

Vidu Q4 Preview 图生视频的提示词怎么写？

主体在前：先写画面主角与动作，再补环境、光线、风格（"一名宇航员在雨中的霓虹街头奔跑，电影感，浅景深"）。
用具体名词代替形容词堆砌："85mm 人像镜头、黄昏逆光" 比 "非常好看、超高质量" 有效得多。
迭代时只改一个变量：固定 seed 复现结果，每次只调整一个描述词，才能知道是什么在起作用。
负面信息放正面写：与其说"不要模糊"，不如直接要"锐利对焦、清晰细节"。

价格是多少？

按次积分计价，典型一次调用约 $0.475（$1 = 100 积分），实际价格随参数（分辨率/时长等）变化，Playground 里提交前会显示准确报价。

Vidu Q4 Preview 图生视频

vidu/q4-preview/image-to-video

根据提示词和单张图片生成 3～16 秒视频，支持可选音频和提示词扩展，以及 540p、720p、1080p、2k、4k 分辨率。

参数

参数	类型	必填	默认值	范围／说明
`prompt`	string	是	—	max 5000 chars; 用于生成的正向提示词。
`image`	array	是	—	1–1 URLs; 首帧图片 URL 数组（1 张）。
`resolution`	string	否	"720p"	540p, 720p, 1080p, 2k, 4k; 生成媒体的分辨率。
`duration`	integer	否	5	3–16; step 1; 生成媒体的时长（秒）。
`enable_prompt_expansion`	boolean	否	false	是否启用 AI 提示词改写。
`generate_audio`	boolean	否	true	是否生成音频。
`seed`	integer	否	—	生成时使用的随机种子。-1 表示使用随机种子。

prompt 和 image 必填。Nami 的 image 使用单元素 URL 数组。seed=-1 表示随机种子。AI 提示词扩展可选，默认关闭。

价格

Resolution	USD / second	Credits / second	USD / 5 seconds
540p	$0.045	4.5	$0.225
720p	$0.095	9.5	$0.475
1080p	$0.12	12	$0.6
2k	$0.19	19	$0.95
4k	$0.39	39	$1.95

总价=分辨率单价 × duration。duration 支持 3～16 的整数秒，默认 720p、5 秒、开启音频，默认总价为 $0.475，即 47.5 积分。只有分辨率和时长影响价格，音频生成、种子及本接口支持的参考素材或提示词扩展不额外收费。1 美元=100 积分。标价与 WaveSpeed 一致，账户折扣另行计算。

API

curl -X POST https://www.namifusion.com/api/v1/marketplace/run/vidu/q4-preview/image-to-video \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "input": {
    "prompt": "A sleek luxury perfume bottle on a glossy black pedestal slowly rotates as soft golden light sweeps across the glass, revealing elegant reflections and floating particles in the air. The camera performs a smooth cinematic push-in with subtle parallax, creating a premium advertising look. High detail, refined motion, realistic lighting, polished product-commercial style.",
    "image": [
      "https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/10/09/7598f96abcb7.jpeg"
    ],
    "resolution": "720p",
    "duration": 5,
    "enable_prompt_expansion": false,
    "generate_audio": true,
    "seed": -1
  }
}'

curl 'https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID' \
  -H "Authorization: Bearer $API_KEY"

提交响应返回 task_uuid；轮询至 completed 或 failed。成功时 output.videos 是视频 URL 数组。

WaveSpeed

完整参数表、输出字段与实时价格 →

常见问题

可以先免费试用吗？+

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

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

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

内容政策是什么？+

色情内容、涉及未成年人的性化内容、未经授权使用真人、欺骗性冒充、诈骗与虚假代言均禁止。合法、自愿且非露骨的成年人主题可能被允许，详见服务条款。

Vidu Q4 Preview 图生视频的任务要跑多久？+

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

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

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

免费试用 →