# 云枢 API Grok CLI 生视频使用与计费避坑指南

更新日期：2026-08-03  
适用范围：通过 Grok CLI 使用云枢 API 的自然语言文生视频功能

## 当前状态

Grok CLI 已支持在普通对话中直接生成视频，真实生成与计费已经验证正常。

连接配置保持不变：

| 配置项 | 填写内容 |
| --- | --- |
| Base URL | `https://yunshuapi.wiki/grok-media/v1` |
| Grok CLI 模型 | `grok-4.5` |
| API Backend | `responses` |
| API Key | 您自己的云枢 API Key |

服务端识别到明确的视频请求后，默认使用 `grok-imagine-video` 执行生成。需要图生视频 1.5 Preview 时，可以在当前提示词中显式选择 `grok-imagine-video-1.5-preview`。不要把 Grok CLI 配置中的模型手动改成视频模型。

本功能不要求安装额外 Skill、脚本或插件。已经可以通过同一配置生图的用户，不需要重新配置。

## 必须使用的提示词格式

当前最稳妥的写法，是把“生成视频：”放在消息最前面，随后立即写清时长和分辨率：

```text
生成视频：时长[1-15]秒，分辨率[480p或720p]，画面比例[例如16:9]。画面内容：[主体、环境和动作]。镜头：[景别、机位和运镜]。风格：[写实、电影感、动画等]。要求：[光影、运动连续性和需要避免的内容]。无文字、无字幕、无水印。
```

正确示例：

```text
生成视频：时长5秒，分辨率480p，画面比例16:9。清晨的现代城市天台上，一架红色纸飞机随微风起飞，穿过三道透明玻璃圆环，最后平稳落在木桌上。写实电影感，单镜头连续跟拍，运动自然流畅，光影真实，主体清晰，无文字、无字幕、无水印。
```

不推荐：

```text
生成一段5秒、16:9的写实电影感、单镜头连续跟拍、光影真实的视频。
```

第二种写法把“生成”和“视频”隔得太远，可能无法命中视频桥，随后被当作普通文字请求处理。画面比例属于提示词要求，最终构图仍以实际生成结果为准。

## 使用 Grok Video 1.5 Preview

`grok-imagine-video-1.5-preview` 同时支持纯文字生成和带参考图生成。两种方式都必须写出完整模型名。

纯文字生成模板：

```text
使用 grok-imagine-video-1.5-preview 生成视频：时长[1-15]秒，分辨率[480p或720p]，画面比例[例如16:9]。画面内容：[主体、环境和动作]。镜头：[景别、机位和运镜]。风格：[写实、电影感、动画等]。无文字、无字幕、无水印。
```

纯文字示例：

```text
使用 grok-imagine-video-1.5-preview 生成视频：时长5秒，分辨率720p，画面比例16:9。雨夜的未来城市街道上，一辆银色悬浮汽车从霓虹招牌下缓慢驶过，低机位连续跟拍，写实电影感，运动自然，无文字、无字幕、无水印。
```

带参考图生成模板：

```text
使用 grok-imagine-video-1.5-preview 生成视频：时长[1-15]秒，分辨率[480p或720p]。让参考图中的[主体]执行[动作]。镜头：[运镜要求]。要求：[运动连续性、光影和需要避免的内容]。无文字、无字幕、无水印。
```

操作要求：

- 纯文字生成不需要参考图；
- 图生视频一次最多附带一张参考图；
- 只写“1.5”“Preview”不会切换模型，必须写完整的 `grok-imagine-video-1.5-preview`；
- Grok CLI 配置中的 Model 仍保持 `grok-4.5`；
- Preview 的权限和费用以控制台实时显示为准。

## 支持规格与当前价格

| 项目 | 当前支持 |
| --- | --- |
| 时长 | 1-15 秒；省略时默认 4 秒 |
| 分辨率 | 480p、720p；省略时默认 480p |
| 480p 当前价格 | 0.5 元/秒 |
| 5 秒 480p 预计基础费用 | 2.5 元 |
| 输出 | 异步生成 MP4，并返回临时下载链接 |

720p 高于相同时长的 480p。价格可能调整，最终以提交时控制台显示的实时价格为准。

即使系统有默认值，也建议每次明确写出时长和分辨率。这样可以在提交前估算费用，并减少误解。

## 正确操作流程

1. 确认 Grok CLI 当前使用云枢媒体配置：`grok-4.5`、`responses` 和 `/grok-media/v1`。
2. 新建会话，避免很长的旧上下文干扰意图识别。
3. 标准视频使用“生成视频：”开头；Preview 写完整模型名，按需要选择纯文字或附带一张参考图。
4. 提交一次后等待明确结果，不要重复回车，也不要在其他终端再次提交。
5. 成功后立即下载 MP4，并保存任务 ID 和生成时间。
6. 到云枢 API 控制台核对实际命中的 `grok-imagine-video` 或 `grok-imagine-video-1.5-preview`、视频秒数和费用。

## 出现这些情况要立即停止

直接文生视频不需要先生成关键帧。出现以下任一情况，都说明可能没有进入预期的视频流程：

- 界面显示正在调用 `imagine`；
- 提示先生成关键帧，再制作视频；
- 图片生成失败后自动重试；
- 同一个工具连续出现两次或更多；
- 长时间停留在 `Waiting for response...`，同时仍在增加工具调用。

处理步骤：

1. 立即按 `Esc`；
2. 如果没有停止，按 `Ctrl+C`；
3. 不要输入“继续”“重试”或“再试一次”；
4. 到控制台核对本次时段的消费记录；
5. 确认没有仍在执行的任务后，新建会话并使用标准模板重新提交一次。

每次独立重试都可能成为新的付费请求。不要依赖客户端自动重试来避免重复计费。

## 下载链接过期或返回 403

视频下载链接带有签名，通常约 10 分钟有效。链接过期、返回 403 或浏览器下载失败，不代表视频任务没有完成。

遇到下载问题时：

1. 不要重新生成同一个视频；
2. 保留原任务 ID、生成时间和错误信息；
3. 联系云枢 API 客服处理下载链接；
4. 提供截图时遮住完整 API Key 和其他账号隐私。

重新提交生成提示词会创建一个新的完整视频任务，并产生新的费用。

## 如何核对费用

| 消费记录中的模型 | 通常代表 | 计费方式 |
| --- | --- | --- |
| `grok-imagine-video` | 实际执行了视频生成 | 按时长、分辨率和当时价格计费 |
| `grok-4.5` | 普通文字、未命中视频桥的请求或失败后的重试 | 按文字 Token 计费 |
| `grok-imagine-image` | 请求进入了图片生成流程 | 按实际图片数量和当时价格计费 |

视频流程中的 `session_title` 会话标题辅助请求已经由服务端本地处理，正常情况下不应再产生额外的 `grok-4.5` 标题费用。

如果只提交一次，却出现非预期的多条记录，应先停止重试，按时间核对模型、请求数量和视频秒数，再联系客服。

## 当前边界

- 本指南重点说明普通对话中的直接文生视频。
- 使用参考图片的图生视频属于另一种输入流程，本指南不建议新手直接照猜本地路径或参数。
- “生成视频：”开头的标准模板是当前最可靠的方式；任意自然语言写法并不等价安全。
- 临时下载链接不是永久网盘，生成成功后应及时保存到本地。

## 提交前检查清单

- [ ] Base URL 是 `https://yunshuapi.wiki/grok-media/v1`
- [ ] Grok CLI 模型是 `grok-4.5`
- [ ] API Backend 是 `responses`
- [ ] 提示词第一句以“生成视频：”开头
- [ ] 已明确写出 1-15 秒和 480p/720p
- [ ] 已了解当前价格并估算本次费用
- [ ] 当前没有其他窗口或设备提交同一请求
- [ ] 如果出现 `imagine` 或关键帧流程，会立即取消
- [ ] 下载失败时会保留任务 ID，而不是重新生成

---

云枢 API：<https://yunshuapi.wiki/>  
请妥善保管 API Key。任何客服人员都不应要求您发送完整 Key。