---
description: "腾讯 WAND-Vega 视频模型直调：预冻结上限，完工按实耗多退少补。"
---

# 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 拒单）。

```bash
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 元/张加收）：

```bash
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`：

```json
{
  "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 过期），未完成返回
上游未就绪错误：

```bash
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 过期，及时下载。