HiAPI
博客

使用指南

Vidu Q4 Preview 参考生视频:面向带旁白、带品牌的短视频

端到端完成一条 9:16 短视频:锁定一套品牌素材包和一种声音,批量生成片段,以 4K 母版制作,最终交付 1080p。

2026年11月3日
Vidu Q4 Preview 参考生视频:面向带旁白、带品牌的短视频

大多数短视频「AI 视频」教程只教你做一条好看的独立片段,而一条品牌短视频需要的恰恰相反:连续三到四个片段中,同一吉祥物、同一产品、同一旁白声音要贯穿每一个镜头。这种一致性正是 vidu-q4-preview/reference-to-video 的用武之地——你给它一小套参考图片(以及可选的语音样本),之后每次渲染都复用这套素材,而不是每次都重新掷一次外观的骰子。

这是一篇工作流实战讲解,不是提示词清单。我端到端做出了一条约 14 秒的竖版短视频——钩子、带旁白的主体、行动号召——只用两张图片组成的品牌素材包和一个语音样本,然后批量生成、拼接,并导出为适合 9:16 信息流的成品。下面的每个片段、每项成本和每个字段,都来自这次在 hiapi Vidu Q4 Preview 参考生视频模型上的实际运行。

太长不看版

  • 品牌素材包只锁定一次。reference_image_urls(1–15 张图片)保持你的角色和产品一致;reference_audio_urls(最多 3 个)保持旁白声音一致。短视频里的每个片段都复用同一套素材包。
  • 原生竖屏拍摄。aspect_ratio: "9:16" 渲染出真正的 1080×1920(4K 下为 2160×3840)画面——无需后期裁切。
  • 4K 做母版,1080p 交付。4K 输出为 2160×3840 HEVC/H.265;将其重新编码为 H.264 并降采样到 1080×1920 供信息流发布。我把钩子保留在 4K,主体/CTA 用 1080p。
  • 批量提交,不要干等。这是异步任务 API——先提交全部三个片段,再轮询。实际耗时取决于最慢的那个片段,而不是三者之和。
  • 按秒算预算。1080p 为 $0.1375/秒,4K 为 $0.446/秒,按 duration 计费。我这条三片段短视频的视频成本为 $3.16。

为什么参考生视频适合带旁白的短视频(而图生视频不合适)

带货类短视频有固定结构——阻止滑走的钩子、讲解的主体、促成转化的 CTA。如果每一段都是单独渲染,最大的风险不是动作质量,而是漂移:吉祥物比例变了、产品质感变了、声音听起来像另一个品牌。参考生视频直接正面解决这个问题:

  • reference_image_urls 是你的视觉锁。一张角色肖像加一张产品静帧,就成为三个片段固定的素材包。你在提示词中用序号指代它们(「参考图 1 中的机器人」「参考图 2 中的设备」),这样模型就知道哪个素材是哪个。
  • reference_audio_urls 是你的声音锁。传入一段短语音样本并复用到每个带旁白的片段,语音轨就能保持相同音色。(Vidu Q3 也接受该字段,所以语音参考不是 Q4 的独有优势——Q4 相对 Q3 的优势是 4K 输出和最多 15 张参考图。)
  • 4K + 原生 9:16 给你一个清晰的竖版母版,之后可以重新构图或另作他用。

这就是它与图生视频的分界线。Vidu Q4 Preview 图生视频模型是让单张首帧动起来——适合单个镜头,但无法在多片段序列中同时保持角色、产品和声音一致。当交付物是一整条短视频而不是一个节拍时,你才需要参考生视频。

第 1 步——一次性搭建品牌素材包

整条短视频只靠两张参考静帧和一段语音片段运行。我在 hiapi 上生成了两张静帧(任何干净、光线良好的影棚图都可以——模型会读取形状、材质和颜色,所以纯色背景有助于它分离主体):

至于声音,我用文本转语音模型做了一段约 10 秒的旁白样本,上传到公共 URL,那个文件就成了带旁白片段的语音参考。素材包的意义在于复用:这三个素材 URL 会被粘贴到下面每个相关请求中,这正是无论你渲染三个还是三十个片段,短视频都能保持连贯的原因。

几条重要的准备规则:

  • 参考静帧使用干净、均匀的背景,让主体清晰可辨。
  • 提交前把每个参考素材(图片和音频)托管在可访问的公共 URL 上——任务 API 会在服务端抓取它们。
  • 提前确定品牌的规范画幅;对于信息流短视频,每个片段都用 9:16。

第 2 步——钩子(4K 渲染,导出为 1080×1920)

开场片段只有一个任务:让首帧就有运动。我特意用 4K 渲染——不是因为信息流需要 4K(并不需要),而是因为 2160×3840 母版给了你推近、重新构图成 1:1 或 16:9 用于其他投放位置、以及保留高质量存档的空间。然后你再导出一份 1080×1920 副本给平台。

我运行的提示词(一张参考图,无音频):

The rounded white robot mascot from reference image 1 bounces up into the
centre of a bright minimalist desk scene, its teal eyes brightening as it
gives a cheerful two-arm wave toward the camera. Soft studio light, shallow
depth of field, gentle bokeh, clean pastel background, playful energetic
motion, subtle teal rim light. Vertical social-video framing.
{
  "model": "vidu-q4-preview/reference-to-video",
  "input": {
    "prompt": "...",
    "reference_image_urls": ["https://.../paxel-mascot.jpg"],
    "resolution": "4k",
    "duration": 4,
    "aspect_ratio": "9:16"
  }
}

实际返回并验证的结果:一个 4 秒的 2160×3840 文件——这证实 resolution 设定的是 9:16 画幅的短边,而不是固定标签。4K 输出以 HEVC/H.265(10-bit) 交付,大多数浏览器和部分剪辑软件无法内联播放,所以这里唯一不可省略的步骤是重新编码:

ffmpeg -i hook_4k.mp4 -vf "scale=1080:1920" \
  -c:v libx264 -profile:v high -pix_fmt yuv420p -crf 20 \
  -c:a aac -movflags +faststart hook_1080.mp4

这样你就得到一条到处都能播放的 H.264 1080×1920 片段,同时把 4K 原片保留为母版。(如果你不需要 4K 母版,可以直接用 1080p 渲染钩子并跳过降采样——每秒还便宜约 3 倍。)

第 3 步——带旁白的主体(语音参考)

这是使用整套素材包的片段:两张参考图以及语音样本。模型把吉祥物放在产品旁边,让它说话,并借用参考音频的音色。

The white robot mascot from reference image 1 stands beside the matte-white
pebble focus device from reference image 2 on a tidy wooden desk, turns to the
camera and speaks warmly, gesturing toward the glowing teal device as if
introducing it; it speaks in the voice of reference audio 1. Soft daylight,
cosy home-office background, gentle handheld sway, friendly inviting mood.
Vertical framing.
{
  "model": "vidu-q4-preview/reference-to-video",
  "input": {
    "prompt": "...",
    "reference_image_urls": ["https://.../paxel-mascot.jpg",
                             "https://.../paxel-device.jpg"],
    "reference_audio_urls": ["https://.../paxel-narrator.mp3"],
    "resolution": "1080p",
    "duration": 6,
    "aspect_ratio": "9:16"
  }
}

这次运行中有两点需要知道:

  1. 字段名是 reference_audio_urls。我试过 voice_reference_urls,API 拒绝了它(additional properties 'voice_reference_urls' not allowed),所以要使用准确名称。它最多接受三个音频片段。
  2. 无论如何,每个输出都带 AAC 音轨。没有音频参考的片段返回时同样带声音轨。区别体现在电平上:我的旁白主体片段测得平均响度约 -20 dB——明显是人声片段——而近乎无声的 CTA 约为 -35 dB。如果你想在一系列视频中保持一致的旁白,就在每个带旁白的片段上复用同一个音频 URL;这正是要一次性锁定声音的全部理由。

第 4 步——CTA

一个简短有力的收尾:吉祥物与产品互动,品牌的青色点缀亮起,然后它回头看向镜头。两张参考图都用上,这次不用语音。

Close vertical shot: the white robot mascot from reference image 1 reaches out
and taps the top button of the pebble device from reference image 2; the teal
LED ring pulses to life with a soft glow, and the mascot looks up at the camera
with bright teal eyes and a small confident nod. Clean minimalist desk, soft
light, crisp focus, upbeat finish. Vertical framing.

以 1080p 渲染 4 秒——产品的青色圆环保住了参考静帧中的颜色,这就是把设备作为专用参考图提供、而不是用文字描述它的回报。

第 5 步——批量提交渲染,不要守着它们

参考生视频是一个异步任务 API:你 POST 一个任务,拿到 taskId,然后轮询结果。对于三片段短视频,先提交全部三个,再轮询——你的实际耗时变成最慢的那个片段,而不是三者之和。

import requests, time

BASE = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": "Bearer YOUR_KEY", "Content-Type": "application/json"}

clips = [hook_input, body_input, cta_input]   # the three input dicts above
ids = []
for c in clips:
    r = requests.post(BASE, headers=H, json={
        "model": "vidu-q4-preview/reference-to-video", "input": c})
    ids.append(r.json()["data"]["taskId"])     # save IDs immediately

results = {}
while len(results) < len(ids):
    for tid in ids:
        if tid in results:
            continue
        data = requests.get(f"{BASE}/{tid}", headers=H).json()["data"]
        if data["status"] == "success":
            results[tid] = data["output"][0]["url"]   # download now — URLs expire
        elif data["status"] == "fail":
            results[tid] = None                        # handle/retry
    time.sleep(6)

拿到每个 taskId 时立刻保存,任务成功后立刻下载输出 URL——它们是限时直链。完整的集成约定——轮询、回调、幂等性以及校验错误表——请参阅 Vidu Q4 Preview 参考生视频 API 指南和 tasks API 参考。

第 6 步——拼接并导出用于信息流

三个片段下载好后,用 ffmpeg 组装短视频。先把所有片段统一到相同的编解码器、分辨率和帧率(我的片段返回时是 24 fps;我重新编码为 30),然后拼接:

ffmpeg -i hook_1080.mp4 -i body.mp4 -i cta.mp4 \
  -filter_complex "[0:v][0:a][1:v][1:a][2:v][2:a]concat=n=3:v=1:a=1[v][a]" \
  -map "[v]" -map "[a]" -c:v libx264 -pix_fmt yuv420p \
  -c:a aac -movflags +faststart short_full.mp4

这样就生成了本页顶部那条 14 秒 1080×1920 短视频。对短视频重要的导出说明:

  • 保持竖屏,保持简短。duration 是 3 到 16 秒的整数,按片段计;3–4 个片段的序列可以轻松落在信息流的注意力窗口内。
  • 降采样 4K 母版。组装版本使用的是钩子的 1080×1920 导出,而不是 HEVC 原片。
  • 注意音轨。因为每个片段都带 AAC,拼接时要刻意设置电平,而不是假设它是静音。

成本

定价按输出秒数计算,按分辨率固定,乘以 duration(已对照实时定价页面确认):

分辨率 价格 / 秒
540p $0.0515
720p $0.109
1080p $0.1375
2K $0.2175
4K $0.446

我这条短视频的实际成本:

片段 分辨率 时长 成本
钩子 4K 4 秒 $1.784
主体(语音) 1080p 6 秒 $0.825
CTA 1080p 4 秒 $0.550
视频总计 14 秒 $3.159

品牌素材包准备——两张参考静帧和一段短 TTS 语音样本——只额外增加了几美分。最大的成本杠杆是钩子的 4K:把它降到 1080p,整条短视频就降到约 $1.92。只有当你确实想要一个可重新构图的母版时,才用 4K 渲染钩子。

字段参考(短视频速查表)

字段 说明
prompt 必填。用序号指代参考素材(「参考图 1」「参考音频 1」)。
reference_image_urls 必填。数组,1–15 张图片。你的视觉品牌素材包。
reference_audio_urls 可选。数组,最多 3 个。声音锁。精确字段名——voice_reference_urls 会被拒绝。
resolution 540p / 720p / 1080p / 2k / 4k。设定短边。4K 返回 HEVC。
duration 整数,3–16 秒。(像 99 这样的值会返回 400 … want 16。)
aspect_ratio 16:9 / 9:16 / 1:1 / 4:3 / 3:4。信息流原生竖屏用 9:16。

常见问题

这与提示词配方文章有何不同? 不同。参考生视频提示词配方是可复制粘贴的独立创意镜头。本文是制作成品短视频的生产流水线——锁定一套品牌素材包、批量生成片段,并导出按序列拼接的 9:16 交付物。

必须使用语音参考吗? 不——reference_audio_urls 是可选的。没有它片段仍会渲染(且仍带 AAC 音轨)。当你想在一系列视频中保持一致的旁白时再加它。

整条短视频都能用 4K 渲染吗? 可以,但对信息流来说很少值得:4K 是 $0.446/秒,而 1080p 是 $0.1375/秒,而且信息流本来就以 1080×1920 展示。把 4K 留给那个你可能重新构图或另作他用的镜头。

一个片段能有多长? duration 每个片段上限 16 秒。对短视频来说,每片段 3–6 秒、3–4 个片段的序列是最佳区间。

为什么我的 4K 文件无法播放? 4K 返回为 HEVC/H.265(10-bit)。按第 2 步所示,重新编码为 H.264 yuv420p 并加 +faststart,以适配网页和大多数剪辑软件。

打造你自己的品牌短视频

这个模式适用于任何吉祥物、产品或出镜人:锁定参考素材包,写三条按序号引用它的提示词,批量渲染,然后拼接。从 Vidu Q4 Preview 参考生视频模型页面开始,从快速入门获取 API key,今天下午就发布你的第一条竖版短视频。

立即开始构建持久 AI 产物

获取 API 密钥,通过一个基于任务(task)的 API 调用图像、视频和音频模型。

阅读 API 文档