Vega 视频生成

腾讯 WAND-Vega 视频模型直调：提交时预冻结上限、完工按上游实耗多退少补、 失败分文不扣。单模型多档位：分辨率是请求参数，不编码进模型 ID。

模型一览

模型 ID	上游模型	分辨率档位	说明
vega-1.0-lite	wand-vega-video-1.0-lite	480P / 768P / 1080P / 2K / 4K	首发，文生与图片参考已实测
vega-1.0-pro	wand-vega-video-1.0-pro	480P / 720P / 1080P / 2K / 4K	画质更强，无 768P 档
vega-1.5-pro	wand-vega-video-1.5-pro	480P / 720P / 1080P / 2K / 4K	最新，镜头语言更丰富

Token 单价全系 10 元/百万 tokens（成本）；平台售价 = 成本 × 售价系数 （默认 1.2，即 12 元/M），系数可在管理后台按模型配置 （extra.video_pricing.price_multiplier）。

分档售价（元/秒，系数 1.2）

文生/图片参考按输出部分实付；参考视频按满额预冻、完工按实退差。

vega-1.0-lite

分辨率	文生价	满额价
480P	0.3564	0.7128
768P	0.45	0.9
1080P	0.6	1.2
2K	0.75	1.5
4K	0.9	1.8

vega-1.0-pro

分辨率	文生价	满额价
480P	0.4992	0.6264
720P	0.954	1.2
1080P	2.076	2.592
2K	5.16	6.408
4K	5.88	7.2

vega-1.5-pro

分辨率	文生价	满额价
480P	0.7272	1.164
720P	1.4256	1.776
1080P	3.1044	3.792
2K	7.644	9.264
4K	8.4084	10.1904

参考图前 5 张免费，第 6 张起超量 0.18 元/张（售价口径，最多 20 张）； 参考音频免费。时长 4~15 秒，默认 5 秒。

提交生成

POST https://oneapi.zaiwenai.com/v1/videos/vega/generations

参数	类型	必填	说明
model	string	是	上方模型 ID 之一
prompt	string	是	视频内容描述，最多 7000 字符
resolution	string	否	模型支持的档位之一；缺省走首档，仅影响上游默认出片
duration	integer	否	4 至 15 秒，缺省 5
ratio	string	否	16:9、9:16、1:1、4:3、3:4、21:9，缺省上游默认
images	array	否	[{url, role}]，role 为 first_frame（首帧，限 1 张）、last_frame（尾帧，限 1 张）、reference_image（参考图）；URL 须为公网 http(s)，base64 不收
reference_videos	array	否	参考视频 URL，最多 3 个，按满额预扣、完工按实退差
reference_audios	array	否	参考音频 URL，最多 3 个，免费

素材合计最多 12 项。首尾帧禁与参考图混用（上游 2013 拒单）。

curl https://oneapi.zaiwenai.com/v1/videos/vega/generations \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "vega-1.0-lite",
    "prompt": "一只橙色小猫在窗台上看向镜头，阳光从侧面洒入，镜头缓缓推进",
    "resolution": "768P",
    "ratio": "16:9",
    "duration": 6
  }'

多图示例（7 张参考图，超 5 张部分按 0.18 元/张加收）：

curl https://oneapi.zaiwenai.com/v1/videos/vega/generations \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "vega-1.0-lite",
    "prompt": "一群朋友在日落时徒步，电影感",
    "resolution": "768P",
    "duration": 6,
    "images": [
      {"url": "https://example.com/ref1.png", "role": "reference_image"},
      {"url": "https://example.com/ref2.png", "role": "reference_image"},
      {"url": "https://example.com/ref3.png", "role": "reference_image"},
      {"url": "https://example.com/ref4.png", "role": "reference_image"},
      {"url": "https://example.com/ref5.png", "role": "reference_image"},
      {"url": "https://example.com/ref6.png", "role": "reference_image"},
      {"url": "https://example.com/ref7.png", "role": "reference_image"}
    ]
  }'

提交成功返回 HTTP 202：

{
  "request_id": "6adf1a76…",
  "task_id": "1300513974-video-…-m0c",
  "model": "vega-1.0-lite",
  "status": "pending",
  "reserved": 3.06,
  "cost_breakdown": {
    "duration_cost": 2.7,
    "image_surcharge": 0.36,
    "overage_images": 2
  },
  "upstream": {"id": "1300513974-video-…-m0c", "status": "queued"}
}

reserved 为预冻结上限（非实扣）；余额不足直接 402，不建单。

查询状态

GET https://oneapi.zaiwenai.com/v1/videos/vega/generations/{task_id}

任务状态存上游，查询为无状态透传，不计费。queued / running 继续轮询 （建议间隔 20 秒以上）；succeeded 触发实结（冻结转实扣，多退少补）， failed 触发全额解冻（调用记录标失败、费用 0）。查询本身 fail-soft， 不阻塞返回。

获取视频地址

GET https://oneapi.zaiwenai.com/v1/videos/vega/generations/{task_id}/content

任务完成后返回 302 + {url}（上游可播放地址，约 12h 过期），未完成返回 上游未就绪错误：

curl https://oneapi.zaiwenai.com/v1/videos/vega/generations/1300513974-video-…-m0c/content \
  -H "Authorization: Bearer $YOUR_API_KEY"

计费说明

• 提交时预冻结上限（余额显示冻结，钱没真正扣）：文生/图片参考按输出单价 × 时长 + 图片超量费；参考视频按满额（输入+输出）× 时长 + 图片超量费。
• 完工结算：查询到 succeeded 时按上游实耗 total_tokens × 售价 真正扣费； 文生单实费恒等于冻结额，参考视频单退输入差额。
• 上游失败：全额解冻，调用记录标失败、费用 0。
• 24h 未完工自动解冻。参考音频免费。
• 查询与取链不产生费用；提交失败（余额不足、参数错误、上游拒单）不冻结。
• 调用记录完工后改写为完工口径备注（含实费 / tokens / 退补），用量明细 （输出 + 超量拆分）与单价快照一并落盘，前端用量页按时长 + tokens 双口径展示。

限制与已知问题

• 只要公网 http(s) URL，不收 base64；国内站公开服务，不做真人活体。
• 参考视频拉取不稳定（实测隧道 / tempfile 直链均失败：InternalError、 media url unreachable）：建议用同地域 CDN / OSS 稳定直链；失败分文不扣， 可重试或改文生/图片参考。
• 参考视频场景上游偶发内部错误（MiniMax-H3 context ir，腾讯侧内部模块名泄漏， 非网关问题）：属上游故障，失败自动解冻，凭 task_id + 错误原文可找腾讯工单。
• 生成视频地址约 12h 过期，及时下载。