APIMart
返回模型总页
Vidu Q4 Preview 模型图标
视频

Vidu Q4 Preview API

APIMart 上的 Vidu Q4 API（model ID 为 viduq4-preview，也常写作 viduq4）：生数科技的 Vidu Q4 Preview 可以把 1 张首帧，或 1–15 张参考图加最多 3 段参考音频，生成 3–16 秒、最高 4K 的视频，默认带原生音频。它是 APIMart 上 Vidu API 系列的最新型号。

图生视频参考生视频3–16 秒最高 4K
获取 API KeyAPI 文档

服务亮点

  • 官方折扣
  • 按量计费
  • 高速低延
Input
5s
Output

Video link valid for 72 hours

定价详情

透明定价，无隐藏费用。按量付费，用多少付多少。

型号规格黄金价当前价格铂金价钻石价官方价为你节省
viduq4-preview540p0.448Credits(~$0.0448)/秒0.4256Credits(~$0.0426)/秒0.4032Credits(~$0.0403)/秒0.56Credits(~$0.056)/秒20%
720p0.912Credits(~$0.0912)/秒0.8664Credits(~$0.0866)/秒0.8208Credits(~$0.0821)/秒1.14Credits(~$0.114)/秒20%
1080p1.024Credits(~$0.1024)/秒0.9728Credits(~$0.0973)/秒0.9216Credits(~$0.0922)/秒1.28Credits(~$0.128)/秒20%
2K1.624Credits(~$0.1624)/秒1.5428Credits(~$0.1543)/秒1.4616Credits(~$0.1462)/秒2.03Credits(~$0.203)/秒20%
4K3.328Credits(~$0.3328)/秒3.1616Credits(~$0.3162)/秒2.9952Credits(~$0.2995)/秒4.16Credits(~$0.416)/秒20%

* 实际费用以最终输出为准。

Vidu Q4 API：用图片和参考素材生成最高 4K 视频

在上方生成器里在线生成 Vidu Q4 视频，或在自己的应用里调用 Vidu Q4 API。可以只用 1 张首帧加可选提示词，也可以组合 1–15 张参考图、提示词和最多 3 段 MP3。时长 3–16 秒，分辨率 540p 到 4K；默认带音频，价格不变。

Vidu Q4 Preview API 核心能力

已接入的图片输入、输出控制与异步任务流程

单首帧与参考图片

图生视频使用一张首帧，参考生视频使用 1–15 张图片。支持 PNG、JPEG、WEBP，每张不超过 50 MB；不支持纯文本输入或尾帧控制。

按模式设置提示词

使用最多 20,000 字符描述动作、镜头或场景。单首帧模式可不填写提示词，参考生视频必须填写提示词。

五档输出分辨率

支持 540p、720p、1080p、2K 与 4K，默认 720p。根据展示渠道、画面需求与预算选择合适档位。

3–16 秒视频时长

时长支持 3 至 16 秒的整数，默认 5 秒。可以先用短片评估动作效果，再规划更长的镜头内容。

生成音轨与参考音频

生成音轨默认开启，关闭后价格不变。参考生视频还可使用最多 3 段 MP3，每段 3–12 秒且不超过 50 MB，参考素材不额外收费。

种子参数

可使用整数种子探索相关结果，不传或设为 0 表示随机。发布前仍应检查生成画面的动作、细节与适用性。

统一异步任务流程

通过 POST /v1/videos/generations 提交后保留 task_id，再查询 GET /v1/tasks/{task_id}，直到完成或失败，无需重复创建任务。

按分辨率与秒数计费

两种模式均按时长乘以当前分辨率的每秒单价计费。参考图片、参考音频及生成音轨均不额外加价；请查看账户实时价格，失败任务全额退款。

图生视频与参考生视频使用场景

从已确认的首帧或参考素材出发的创作流程

商品与品牌短片

将商品照片转成简短展示镜头，通过提示词描述运动方向，并检查成片中的产品细节与品牌适用性。

社交媒体内容

把选定图片转成 3–16 秒的短视频开场，根据发布渠道选择分辨率，并决定使用音轨还是无声输出。

故事分镜与提案

将一张故事板转为动态片段，或结合参考图和提示词探索场景及镜头方向。将片段加入成片前逐一审核效果。

角色动作研究

让肖像或插画产生动作，也可用角色参考图和可选参考音频引导场景。使用前检查角色身份、动作表现与内容适用性。

知识讲解与教学

让准备好的场景图或插画产生动态，用于短教学片段。审核视觉准确性后，再添加经过核实的配音或字幕。

游戏概念与环境展示

围绕单张环境概念图或游戏场景探索动态效果，将生成片段用于氛围讨论和团队内部创意评审。

如何获取 Vidu Q4 API Key 并开始

三步完成在 APIMart 的第一个 Vidu Q4 视频。

1

注册并充值

创建 APIMart 账户并充值余额，可用于平台上的所有模型，包括 Vidu API。

2

创建 API Key

在控制台生成 API Key。同一个 Key 可调用 Vidu Q4 和 APIMart 上的其他模型。

3

发送第一个请求

POST /v1/videos/generations，model 设为 viduq4-preview，然后轮询 GET /v1/tasks/{task_id} 直到视频生成完成。

开启创作

Vidu Q4 API 调用示例：图生视频与参考生视频

在 APIMart 用一次 POST 请求调用 Vidu Q4 Preview。生成是异步的：先提交任务，再轮询任务接口获取视频地址。

  1. 1

    为 Vidu Q4 API 请求设置鉴权

    把 APIMart Key 保存在环境变量 APIMART_API_KEY 中，每次请求都带上 Authorization: Bearer <key>。

  2. 2

    提交 Vidu Q4 任务

    POST /v1/videos/generations，model 设为 viduq4-preview，并按示例传入素材。任务 ID 在 data[0].task_id。

  3. 3

    获取 Vidu Q4 视频

    轮询 GET /v1/tasks/{task_id} 直到 status 为 completed，再从 data.result.videos[0].url[0] 读取视频地址。结果保留 72 小时，请及时下载。

    全部参数、素材规则和响应字段请查看Vidu Q4 Preview API 文档。

POST /v1/videos/generations
curl -X POST https://api.apimart.ai/v1/videos/generations \
  -H "Authorization: Bearer $APIMART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq4-preview",
    "prompt": "镜头缓慢推近，人物转身微笑",
    "image_urls": [
      "https://example.com/first-frame.png"
    ],
    "duration": 5,
    "resolution": "720p",
    "audio": true
  }'

Vidu Q4 API 参数

参数类型必填默认值说明
modelstring是默认值: —填写 viduq4-preview。
promptstring否默认值: —最多 20,000 字符。图生视频可选，参考生视频必填。
image_urlsstring[]否默认值: —公网 URL 或 Base64 Data URL。图生视频传 1 张，参考生视频传 1–15 张。
image_with_rolesobject[]否默认值: —带角色的图片：first_frame（首帧），或 reference_image（参考生视频的参考图）。
first_frame_imagestring否默认值: —仅用于图生视频的首帧，不要与其他图片或音频同时传。
audio_urlsstring[]否默认值: —最多 3 段 MP3 参考音频，每段 3–12 秒，仅用于参考生视频。
durationinteger否默认值: 5视频时长（秒）：3–16，默认 5。
resolutionstring否默认值: 720p输出分辨率：540p、720p、1080p、2K 或 4K，默认 720p。
aspect_ratiostring否默认值: 16:9参考生视频可选 1:1、9:16、16:9、3:4、4:3，默认 16:9；图生视频忽略此参数。
audioboolean否默认值: true生成对白和音效。默认 true；false 输出无声视频。
seedinteger否默认值: —整数随机种子，用于控制随机性；不传则随机。

Vidu API 系列型号对比

对比 APIMart 上所有 Vidu 视频型号。一个 API Key 即可调用全部型号，按视频秒数计费。

型号适用场景分辨率时长
Vidu Q4 Preview API当前页面最新一代：首帧图生视频，或 1–15 张参考图搭配最多 3 段参考音频540p – 4K3–16 秒
Vidu Q3 Pro API文生视频、图生视频与首尾帧，默认带音频540p / 720p / 1080p1–16 秒
Vidu Q3 Turbo API与 Vidu Q3 Pro 模式相同，每秒价格为 Vidu 系列最低540p / 720p / 1080p1–16 秒
Vidu Q3 API1–7 张参考图生视频，日常通用，擅长多角度智能运镜切换540p / 720p / 1080p3–16 秒
Vidu Q3 Mix API1–7 张参考图生视频，高画质版本，智能转场更强并支持短动作效果720p / 1080p1–16 秒

Vidu Q4 Preview API 常见问题

了解输入、参数、费用与结果处理

Vidu Q4 Preview 是什么？

Vidu Q4 Preview 是生数科技在 APIMart 上最新的 Vidu 视频模型，也常被搜作 Vidu Q4、viduq4 或 Vidu AI Q4，API ID 为 viduq4-preview。它可以让 1 张首帧动起来，或按 1–15 张参考图（可加参考音频）生成视频，输出 3–16 秒、最高 4K。

Vidu Q4 什么时候发布的？

生数科技于 2026 年 10 月 7 日发布了 Vidu Q4 Preview，Vidu Q4 正式版的发布日期尚未公布。在 APIMart 上，Vidu Q4 API 通过 model ID viduq4-preview 调用 Vidu Q4 Preview。

Vidu Q4 Preview 和 Vidu Q4 API 是一回事吗？

是的。Vidu Q4 Preview 是 Vidu Q4 目前可用的版本，APIMart 的 Vidu Q4 API 通过 model ID viduq4-preview 调用它。model ID 需按原样以小写填写。

Vidu Q4 Preview 支持文生视频吗？

不支持。viduq4-preview 必须提供图片：图生视频使用一张首帧，参考生视频使用 1–15 张参考图，并可加入最多 3 段参考音频。不支持纯文生视频或首尾帧控制。

如何选择首帧或参考素材输入？

first_frame_image 或 first_frame 角色用于图生视频；未标记角色的单图且无参考音频时也走图生模式。reference_image 角色（别名 reference）、多图，或未标记图片配合参考音频会走参考生模式。显式首帧不能与参考图或参考音频混用。image_urls 与 image_with_roles 合计最多 15 张参考图。PNG、JPEG/JPG、WEBP 每张不超过 50 MB，Base64 请求体须小于 20 MB。

提示词是必填的吗？

图生视频的提示词可选，参考生视频的提示词必填，两种模式均最多 20,000 字符。可描述预期动作、场景，以及希望如何运用参考素材。

Vidu Q4 最长能生成多少秒的视频？支持哪些分辨率？

Vidu Q4 Preview 单个视频最长 16 秒。时长为 3–16 秒整数，默认 5 秒；分辨率支持 540p、720p、1080p、2K、4K，默认 720p。参考生视频支持 1:1、9:16、16:9、3:4、4:3，默认 16:9。aspect_ratio 优先于别名 size；首帧模式忽略这两个字段，按首帧图片确定比例。

音轨和种子怎么设置？

生成音轨 audio 默认为 true，设为 false 输出无声视频，价格相同。参考生可加入 0–3 段 MP3，每段 3–12 秒、不超过 50 MB；音频格式与时长由上游检查，不合规可能导致异步失败并退款。seed 接受整数，省略或设为 0 时随机。

Vidu Q4 API 多少钱？

Vidu Q4 按所选分辨率、按输出秒数计费。截至 2026 年 11 月 4 日，黄金会员每秒价格为 540p $0.0448、720p $0.0912、1080p $0.1024、2K $0.1624、4K $0.3328，5 秒 720p 视频约 $0.46。有声与无声同价，参考图和参考音频不另收费。价格表显示实时价格。

Vidu Q4 任务失败会扣费吗？

不会。参数错误（例如首帧与参考图混用，或图片、音频数量超限）会在提交时直接返回 HTTP 400，不创建任务、不扣费。任务在生成过程中失败（例如参考音频无效）会自动全额退款。

如何获取 Vidu Q4 API Key？

在 APIMart 注册、充值，然后在 API Keys 页面创建 Key。同一个 Key 可调用 Vidu Q4、Vidu Q3 系列和 APIMart 上的所有其他模型，按量付费，无需订阅。

如何获取生成的视频？

POST /v1/videos/generations 会返回 task_id。每 5–10 秒查询一次 GET /v1/tasks/{task_id}，直到 completed 或 failed。完成后从 data.result.videos[0].url[0] 获取视频地址。

Vidu Q4 生成的视频保留多久？

生成结果保留 72 小时，请及时下载。查询状态超时并不代表任务失败，请继续查询原任务 ID，不要重新提交。

可以在线试用 Vidu Q4 吗？

可以。登录 APIMart、创建 API Key 并充值后，在本页顶部的生成器里就能通过浏览器生成 Vidu Q4 视频。Playground 调用同一个 API，按秒计费、价格相同，完成的视频会出现在最近生成记录里。

Vidu Q4 和 Vidu Q3 怎么选？

需要最高 4K、1–15 张参考图或参考音频时用 Vidu Q4。Vidu Q4 必须传图，所以文生视频或首尾帧请用 Vidu Q3 Pro / Q3 Turbo。用 1–7 张参考图做参考生视频时，Vidu Q3 每秒价格低于 Vidu Q4，Vidu Q3 Mix 则支持最短 1 秒。

Vidu Q4、Seedance 2.5、Kling 4.0 对比：该选哪个？

想用 1 张首帧或最多 15 张参考图生成最高 4K 的视频，选 Vidu Q4；截至 2026 年 11 月 5 日，黄金会员 720p 每秒 $0.0912，但不支持文生视频，单段最长 16 秒。需要最长 30 秒、最高 1080p、文生视频、视频编辑与续写，以及最多 50 个参考素材，选 Seedance 2.5。需要 720p 或 1080p 的 3–30 秒视频、始终带立体声，并支持编辑与续写，选 Kling 4.0。Seedance 2.5 与 Kling 4.0 的价格请看各自的模型页。

相关模型

探索同类型的其他模型。

查看全部模型 →

Vidu Q4 Preview 相关文章

来自 APIMart 博客的教程、对比与价格分析。

查看全部博客文章 →