Vidu Video Q4 Preview

使用 APIMaster API Key：Authorization: Bearer $APIMASTER_API_KEY，请求类型为 application/json。本页完整路径中的 /v1 已包含在 https://apimaster.ai/v1 中，例如 /v1/wand/... 对应 https://apimaster.ai/v1/wand/...。

网关先预留额度，收到上游实际用量后只结算一次，多余预留额度返还。余额不足时请求会在提交前拒绝。网络中断后请保留 request_id，避免盲目重发生成请求。

vidu-video-q4-preview 支持图生与参考生视频，不支持纯文生视频及首尾帧接口。接口路径：图生 POST /v1/wand/vidu/image-to-video；参考生 POST /v1/wand/vidu/reference-to-video；查询 GET /v1/wand/vidu/tasks/{task_id}。Bearer 鉴权，JSON。

参数	类型	适用场景	说明
model	string	全部，必填	vidu-video-q4-preview
images	string[]	图生必填；参考生与 subjects 二选一	图生恰好 1 张；参考生最多 15 张。公网 URL 或 data URI；png/jpeg/jpg/webp，宽高比须在 1:4–4:1 内；URL 单图最多 50MB；Base64 原始图片总量最多 15MB，编码后最多 20MB
subjects	object[]	参考生，与 images 二选一	每项 name 为主体名称/ID，images 为 1–3 张主体图，提示词用 @name 引用；图像限制同上
prompt	string	图生可选；参考生必填	图生/主体参考不超过 5000 字符，直接 images 参考不超过 2000 字符；图生开启 is_rec 时忽略手写 prompt
auto_subjects	boolean	参考生	智能主体库开关，默认 false
audio	boolean	两种	图生默认 true；Q4 参考生默认 false，要有声须显式 true，且使用 subjects 方式
audio_type	string	audio=true 时	all（默认）、speech_only、sound_effect_only
is_rec	boolean	图生	自动推荐提示词，开启每任务额外消耗 10 积分
duration	integer	两种	3–16 秒，默认 5
resolution	string	两种	540p、720p（默认）、1080p、2K、4K
aspect_ratio	string	仅参考生	16:9（默认）、9:16、3:4、4:3、1:1；图生按输入图比例
seed	integer	两种	省略或 0 为随机
payload	string	两种	业务透传，最多 1,048,576 字符
watermark	boolean	两种	默认 false
wm_url	string	两种	自定义水印图片 URL；省略使用默认水印
wm_position	integer	不支持	TokenHub 不接受；开启水印时默认左上角腾讯水印

提交返回 task_id、state、model、prompt、images、duration、audio、seed、resolution、credits、created_at、request_id；字段按场景返回。查询还含 creations[].url、creations[].cover_url、tokenhub_usage.total_tokens。状态 created / queueing / processing / success / failed；每 5–10 秒轮询。URL 有效期 12 小时，成功后及时下载。credits 不能直接作为美元费用，需读取 TokenHub 计费 tokens。

余额、权限、输入图片下载/格式、内容审核、任务不存在、并发限流及内部失败均应作为不同错误处理；任务成功只结算一次，失败终态按预扣退款规则处理。不要因查询超时重新提交任务。

官方单位价 $1.6/百万计费 tokens；540p/720p/1080p/2K/4K 每秒分别 28,125/59,375/75,000/118,750/243,750 tokens，即 $0.045/$0.095/$0.12/$0.19/$0.39。核查日期 2026-11-11。

来源：https://intl.cloud.tencent.com/zh/document/product/1300/84817

任务提交与查询

提交返回的是 APIMaster 公开任务 ID；查询必须使用同一账户的有效 API Key，且该 Key 须有对应模型权限。查询不会重新生成。终态查询可重复执行，不会重复扣款。提交可带 Idempotency-Key（8–128 个可见 ASCII 字符）；同一账户重复使用相同键和参数时返回 202 恢复凭据，不再次提交；同键不同参数返回 409。查询恢复凭据使用通用视频幂等恢复接口，并按响应中的 task_id 查询本页任务路径。callback_url 当前不支持，请轮询。

官方参考价格

下表是腾讯国际站官方目录价（2026-11-11），APIMaster 当前售价请打开对应模型卡。媒体统一按上游实际计费 tokens 结算，每百万计费 tokens $1.60，不能将此单价理解为每张或每秒费用。

模型	规格	用量换算	目录参考价
vidu-video-q4-preview	540P	28125 tokens/秒	0.045 USD/秒
vidu-video-q4-preview	720P	59375 tokens/秒	0.095 USD/秒
vidu-video-q4-preview	1080P	75000 tokens/秒	0.12 USD/秒
vidu-video-q4-preview	2K	118750 tokens/秒	0.19 USD/秒
vidu-video-q4-preview	4K	243750 tokens/秒	0.39 USD/秒

先注册，再在控制台创建密钥，按本页的具体模型 ID 调用 https://apimaster.ai/v1。

2026-11-11 实测：540p、3 秒的两个成功任务均返回 90,000 个计费 tokens，对应官方 token 费率 $0.144；与目录按秒参考价换算的 $0.135 有差异。实际结算读取响应中的 tokenhub_usage.total_tokens，不以按秒参考表覆盖上游用量。