PixVerse V6.0 / C1 — 完整参数与计费
腾讯 TokenHub PixVerse V6.0 / C1 的原生接口、全部请求字段、响应、任务查询和官方参考价格。
PixVerse V6.0 / C1
使用 APIMaster API Key:Authorization: Bearer $APIMASTER_API_KEY,请求类型为 application/json。本页完整路径中的 /v1 已包含在 https://apimaster.ai/v1 中,例如 /v1/wand/... 对应 https://apimaster.ai/v1/wand/...。
网关先预留额度,收到上游实际用量后只结算一次,多余预留额度返还。余额不足时请求会在提交前拒绝。网络中断后请保留 request_id,避免盲目重发生成请求。
模型:pixverse-video-v6.0、pixverse-video-c1。支持四个 POST 路径,前缀 /v1/wand/pixverse/:text-to-video、image-to-video、start-end-to-video、reference-to-video。查询 GET /v1/wand/pixverse/tasks/{task_id}。Bearer 鉴权,JSON。
| 参数 | 类型 | 必填/范围 |
|---|---|---|
| model | string | 必填,以上两个模型 ID |
| prompt | string | 四种路径均必填,最多 5000 字符;参考生可用 @ref_name 引用素材 |
| duration | integer | 必填,1–15 秒,默认值为 5,1080p 也支持到 15 秒 |
| quality | string | 必填,360p / 540p / 720p / 1080p |
| aspect_ratio | string | 仅文生/参考生;16:9(默认)、4:3、1:1、3:4、9:16、2:3、3:2、21:9 |
| seed | integer | 0–2,147,483,647;省略或 0 随机 |
| generate_audio_switch | boolean | 有声 true,静音 false(默认) |
| camera_movement | string | 仅文生/图生;运镜名称,例如 zoom_in,以原厂支持项为准 |
| generate_multi_clip_switch | boolean | 仅 V6.0 的文生/图生;默认 false,C1/首尾帧/参考生均不支持 |
| img_id | string | 图生必填,公网图片 URL 或 Base64;输出按该图比例 |
| img_ids | string[] | 图生的多图模板专用;普通图生不使用 |
| first_frame_img | string | 首尾帧必填,首帧 URL 或 Base64 |
| last_frame_img | string | 首尾帧必填,尾帧 URL 或 Base64;建议首尾比例一致 |
| image_references | object[] | 参考生必填,最多 7 项;每项 img_id 必填,type 可为 subject/background,ref_name 最多 30 字符 |
图生和首尾帧不能传 aspect_ratio,画幅跟随输入图;这些图片字段直接接收 URL/编码数据,不要求预上传。图生说明提及负向提示词,但官方输入参数表未列出对应字段,当前不支持将其作为请求参数。
提交响应必须同时检查 HTTP 与业务 ErrCode(0 成功);ErrMsg 为描述;任务 ID 位于 Resp.video_id。顶层 request_id 用于排错。查询以 Resp.status 为准:1 成功、5 生成中、6 已删除、7 审核失败、8 生成失败。建议每 3–5 秒轮询。
查询返回 Resp.id、status、url、prompt、negative_prompt、seed、style、resolution_ratio、outputWidth、outputHeight、size、create_time、modify_time。成功结果 Resp.url 是临时链接,最长 12 小时,应尽快转存。tokenhub_usage.total_tokens 是实际计费量。HTTP 200 仍可能有业务错误,不能当作生成成功。避免重复创建/重复结算;查询需使用创建任务的账户。
官方费率为 $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,不能将此单价理解为每张或每秒费用。
| 模型 | 规格 | 用量换算 | 目录参考价 |
|---|---|---|---|
pixverse-video-c1 |
有声 - 360p | 每秒折合 22222.22 tokens | 0.0355556 USD/秒 |
pixverse-video-c1 |
有声 - 540p | 每秒折合 27777.78 tokens | 0.0444444 USD/秒 |
pixverse-video-c1 |
有声 - 720p | 每秒折合 36111.11 tokens | 0.0577778 USD/秒 |
pixverse-video-c1 |
有声 - 1080p | 每秒折合 66666.67 tokens | 0.106667 USD/秒 |
pixverse-video-c1 |
无声 - 360p | 每秒折合 16666.67 tokens | 0.0266667 USD/秒 |
pixverse-video-c1 |
无声 - 540p | 每秒折合 22222.22 tokens | 0.0355556 USD/秒 |
pixverse-video-c1 |
无声 - 720p | 每秒折合 27777.78 tokens | 0.0444444 USD/秒 |
pixverse-video-c1 |
无声 - 1080p | 每秒折合 52777.78 tokens | 0.0844444 USD/秒 |
pixverse-video-v6.0 |
有声 - 360p | 每秒折合 19444.44 tokens | 0.0311111 USD/秒 |
pixverse-video-v6.0 |
有声 - 540p | 每秒折合 25000 tokens | 0.04 USD/秒 |
pixverse-video-v6.0 |
有声 - 720p | 每秒折合 33333.33 tokens | 0.0533333 USD/秒 |
pixverse-video-v6.0 |
有声 - 1080p | 每秒折合 63888.89 tokens | 0.102222 USD/秒 |
pixverse-video-v6.0 |
无声 - 360p | 每秒折合 13888.89 tokens | 0.0222222 USD/秒 |
pixverse-video-v6.0 |
无声 - 540p | 每秒折合 19444.44 tokens | 0.0311111 USD/秒 |
pixverse-video-v6.0 |
无声 - 720p | 每秒折合 25000 tokens | 0.04 USD/秒 |
pixverse-video-v6.0 |
无声 - 1080p | 每秒折合 50000 tokens | 0.08 USD/秒 |
