# skill-video · Veo 3.1 视频生成技能

用 Google Veo 3.1 生成视频的 Hermes Agent 技能。一条命令完成：**费用预估 → 提交任务 → 轮询状态 → 下载成片**。

## 为什么有这个技能

网关 `api.fmode.cn` 的 Veo 通道存在一个已知 bug：

```javascript
// new-api: plugins/tasks/google/plugin.js:44
{ method: "GET", path: "/v1beta/models/:model/operations/:task_id", type: "query" }
```

Google 要求用 **POST `:fetchPredictOperation`** 查询任务，插件用 GET，导致每次都返回 `upstream task not found (HTTP 404)` —— 任务能创建，但永远查不到结果。

本技能**绕过网关直连上游**，今天就能用。

## 快速开始

```bash
# 只算钱，不生成
node scripts/gen.mjs --prompt "a cat" --estimate-only

# 生成一条 4 秒测试片（最省钱）
node scripts/gen.mjs --prompt "你的画面描述" --model fast --duration 4 --out ./out.mp4

# 定稿后出高清长片
node scripts/gen.mjs --prompt "你的画面描述" --model standard --duration 8 --resolution 1080p --out ./final.mp4
```

## 参数

| 参数 | 可选值 | 默认 | 费用影响 |
|---|---|---|---|
| `--prompt` | 文本描述（英文更稳） | 必填 | — |
| `--model` | `standard` / `fast` | fast | **fast 便宜 75%** |
| `--duration` | `4` / `6` / `8` | 8 | **时间翻倍 = 费用翻倍** |
| `--ratio` | `16:9` / `9:16` | 16:9 | 不影响 |
| `--resolution` | `720p` / `1080p` | 720p | **1080p 贵 1.8 倍** |
| `--count` | `1` - `4` | 1 | **成倍增加** |
| `--out` | 输出路径 | 自动命名 | — |
| `--estimate-only` | 只算钱 | — | — |

## 费用

按官方价 2 倍计价：

| 模型 | 基础价（8s/720p） | 2 倍后 |
|---|---|---|
| `veo-3.1-generate-001` | $1.38 | **$2.76** |
| `veo-3.1-fast-generate-001` | $0.35 | **$0.70** |

**技能会在生成前自动报预估费用，并给出省钱替代方案。**

### 四条省钱原则

1. **先 fast 试稿，定稿再上标准版** —— 省 75%
2. **时长按需压缩** —— 4s 比 8s 便宜一半
3. **一次多备选不如先出 1 条** —— 方向对了再加数量
4. **1080p 留到最后** —— 720p 定稿再出高清

## 配置

凭据放在 `/opt/data/.fmode/secrets/closeai.key`（closeai 渠道 key）。

## 网关现状（2026-11-05 实测）

| 类型 | 模型 | 状态 |
|---|---|---|
| 图像 | `doubao-seedream-4-0-250828` | ✅ 走网关，正常 |
| 视频 | `veo-3.1-generate-001` | ⚠️ 网关有 bug，需直连 |
| 视频 | `veo-3.1-fast-generate-001` | ⚠️ 同上 |
| 视频 | 即梦 / Seedance / 可灵 / MiniMax / 万相 | ❌ 网关未接入（503） |

> 注意区分：**Seedream 是图像模型**（可用），**Seedance 是视频模型**（网关没有）。

## 实测记录

| 测试 | 参数 | 结果 |
|---|---|---|
| 红苹果 | 8s / 720p / standard | H.264 · 1280×720 · 2.6MB |
| 热汤面 | 4s / 720p / fast | H.264 · 1280×720 · 1.7MB · 15 秒出片 |

## 开发者

- **刘雨飏**（Ryan Liu）· 混沌 AI 领教 · 江西脑控科技有限公司

## 贡献者

- 刘雨飏（Ryan Liu）
- CB