Vidu Q4 Preview

CAPABILITIES

能力与限制

支持模式

首帧参考素材

使用前需了解

必须提供图片，支持首帧或参考图片角色，可附参考音频。不接受纯文字生成、参考视频或尾帧图片。

规格与默认值
参数	支持值 / 默认
分辨率	540p / 720p / 1080p / 2K / 4K
输出时长	3–16 秒
画幅	16:9 · 4:3 · 1:1 · 3:4 · 9:16 · adaptive
提示词限制	20000 Unicode 码点
定义默认值（以模式规则为准）	duration: 5 · resolution: 720p · aspect_ratio: 16:9
参考素材上限	15 图片 / 0 视频 / 3 音频

素材上限不表示所有模式可以组合使用。具体大小、格式与互斥规则见完整字段说明。

查看完整请求字段与限制（中文）↗

字段	字段含义	类型	是否必选	默认值	可选值 / 范围	备注说明（模式与素材限制）	模型专用特殊字段
`model`	调用型号的接口标识	string	是	无	vidu-q4-preview	固定调用名称，按示例精确填写	否
`prompt`	描述内容、动作、镜头或编辑意图的提示词	string	参考是；首帧否	首帧可省略	≤20000 Unicode码点	参考模式不能为空	否
`duration`	输出视频时长，单位秒	integer	否	5	3～16秒	无自动时长	否
`resolution`	输出视频分辨率	string	否	720p	540p / 720p / 1080p / 2K / 4K	按本行可选值选择输出分辨率	否
`aspect_ratio`	输出画幅宽高比	string	否	参考16:9；首帧adaptive	16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive（仅首帧）	首帧省略或adaptive；参考不接受adaptive	否
`first_frame_image`	约束视频开始画面的图片地址	string	首帧模式需提供；可用对应角色替代	无	1张HTTPS图片	首帧恰好1张；不能搭配参考图或音频；图片规格见image_with_roles[].url	否
`image_urls`	图片地址数组	string[]	图片必需；可用其他图片字段替代	无	1～15张参考图	一律作为参考图，单张也不推导为首帧；与reference_image角色合计1～15张，参考模式prompt必填；首帧使用first_frame_image	否
`image_with_roles`	明确指定图片用途的数组	object[]	图片必需；可用其他图片字段替代	无	{url,role}	首帧模式恰好1张、不能搭配参考素材；参考模式1～15张且prompt必填	否
`image_with_roles[].url`	数组内单张图片的地址	string	数组内是	无	HTTPS URL	所有图片字段统一要求：PNG / JPEG / WebP；单文件≤50MiB；可读取有效宽高；不搭配其他参考素材	否
`image_with_roles[].role`	数组内图片的用途	string	数组内是	无	first_frame / reference_image	首帧恰好1张；参考图合计≤15张；不接受尾帧、参考视频或纯文字模式	否
`audio_urls`	参考音频地址数组	string[]	否	无	≤3段MP3	MP3（含Xing/Info）；单文件≤50MiB；单段3～12秒；音频合计≤36秒；仅参考图片模式可用	否
`generate_audio`	是否生成输出视频的声音	boolean	否	true	true / false	输出音轨，不是参考音频字段	否
`seed`	随机种子	integer	否	未指定	JS安全整数	随机种子	是 · Seedance / Wan / Vidu

目录展示已实现的适配能力，不代表所有型号或规格均向当前账户开放。实际启用状态、权限与默认值以本人 /v1/models 为准。

查看完整请求字段与限制（中文）↗

CREATIVE WORKFLOWS

适用场景

让已有首帧图片产生动态。
围绕参考图片构建视频片段。
为图片驱动的工作流搭配参考音频。

概念视觉，非生成样片；本页尚无经过验证的模型实拍样例。

PRICING / USD

按所选规格计费。

售价为 USD。参考价格带采集日期；缺价不代表免费。历史任务仍按创建时的价格快照结算。

正在读取当前价格…

模型价格 ↗

API INTEGRATION

接入示例

在自己的服务端使用 HTTP 接入，选择模型与参数；先由服务方配置账户、Key 和逐模型权限。

202 表示已受理。保存任务编号，按 next_poll_after_seconds 查询；生成状态、产物可用性与费用状态分别判断。

HTTP / cURL

curl --request POST 'https://bytesota-api.businessmodelcraft.com/v1/videos/generations' \
  --header 'Authorization: Bearer YOUR_PLATFORM_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: example-vidu-first-540p-001' \
  --data-raw '{
    "model": "vidu-q4-preview",
    "prompt": "小猫沿花园小径向前走，镜头缓缓跟随。",
    "duration": 5,
    "resolution": "540p",
    "aspect_ratio": "adaptive",
    "generate_audio": true,
    "first_frame_image": "https://assets.example.com/first.png"
  }'

查询结果

HTTP / cURL

curl 'https://bytesota-api.businessmodelcraft.com/v1/tasks/vid_ABCDEFGHIJKLMNOP' \
  --header 'Authorization: Bearer YOUR_PLATFORM_API_KEY'

示例仅供复制，不会在网页中执行；凭证为占位符。

规格与示例来源：模型定义及公开 API 接入指南。

阅读完整 API 文档（中文）↗