Vidu Image Q2 — 完整参数与计费
腾讯 TokenHub Vidu Image Q2 的原生接口、全部请求字段、响应、任务查询和官方参考价格。
Vidu Image Q2
使用 APIMaster API Key：Authorization: Bearer $APIMASTER_API_KEY，请求类型为 application/json。本页完整路径中的 /v1 已包含在 https://apimaster.ai/v1 中，例如 /v1/wand/... 对应 https://apimaster.ai/v1/wand/...。
网关先预留额度，收到上游实际用量后只结算一次，多余预留额度返还。余额不足时请求会在提交前拒绝。网络中断后请保留 request_id，避免盲目重发生成请求。
提交：POST /v1/wand/vidu-image/generation；查询：GET /v1/wand/vidu-image/tasks/{task_id}。均使用 Bearer API Key。JSON 请求，异步生成。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | vidu-image-q2 |
| prompt | string | 是 | 不超过 2000 字符；无参考图时为文生图 |
| images | string[] | 否 | 0–7 张 URL 或 data URI 图片；png/jpeg/jpg/webp；至少 128×128；宽高比在 1:4–4:1 以内；单图不超过 50MB；整个请求不超过 20MB |
| aspect_ratio | string | 否 | 16:9（默认）、9:16、1:1、3:4、4:3、21:9、2:3、3:2、auto；auto 跟随第一张参考图 |
| resolution | string | 否 | 1080p（默认）、2K、4K，大小写按此传递 |
| seed | integer | 否 | 省略或 0 为随机 |
| callback_url | string | 否 | 上游回调参数；APIMaster 当前不接受此字段，请使用任务查询接口轮询 |
提交响应含 task_id、state、prompt、created_at、request_id。state 依次可能为 created、queueing、processing，最终 success 或 failed。成功提交后只轮询，不重复创建。建议每 3–5 秒查询，查询请使用创建任务的账户。
查询响应包含 state、model、aspect_ratio、resolution、creations、request_id、tokenhub_usage。成功图片位于 creations[].url，临时 URL 有效期 12 小时。tokenhub_usage.total_tokens 是计费量；任务查询本身不可重复收取生成费用。
异常分类：缺参/非法字段（BadRequest、FieldLacking、FieldInvalid、FieldUnwanted）；图片数量/尺寸/格式及下载失败；内容审核（TaskPromptPolicyViolation、CreationPolicyViolation、AuditSubmitIllegal）；权限（Unauthorized、Forbidden）；余额（CreditInsufficient）；并发/限流（QuotaExceeded、TooManyRequests）；TaskNotFound；InternalServiceFailure。失败应保留 request_id，按任务终态处理预扣退款。
完整官方参考价格见下表：输入图数量与分辨率共同决定每张图计费 tokens，不能只按分辨率收费。单位价 $1.6/百万计费 tokens，核查日期 2026-11-11。
来源：腾讯官方接口文档
任务提交与查询
提交返回的是 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-image-q2 |
文生图 - 1080P | 每张折合 18750 tokens | 0.03 USD/张 |
vidu-image-q2 |
文生图 - 2K | 每张折合 25000 tokens | 0.04 USD/张 |
vidu-image-q2 |
文生图 - 4K | 每张折合 31250 tokens | 0.05 USD/张 |
vidu-image-q2 |
参考生图（1~3张） - 1080P | 每张折合 25000 tokens | 0.04 USD/张 |
vidu-image-q2 |
参考生图（1~3张） - 2K | 每张折合 37500 tokens | 0.06 USD/张 |
vidu-image-q2 |
参考生图（1~3张） - 4K | 每张折合 62500 tokens | 0.1 USD/张 |
vidu-image-q2 |
参考生图（4~7张） - 1080P | 每张折合 31250 tokens | 0.05 USD/张 |
vidu-image-q2 |
参考生图（4~7张） - 2K | 每张折合 50000 tokens | 0.08 USD/张 |
vidu-image-q2 |
参考生图（4~7张） - 4k | 每张折合 93750 tokens | 0.15 USD/张 |