Grok 视频 API 中文文档
Grok 视频 API 是面向开发者的 AI 视频生成接口，支持通过文本提示、参考图像、关键帧控制等多种方式生成高质量视频。通过 TTAPI 统一网关，你可以稳定访问最新 Grok 模型（包括 grok-imagine-video-1.5-fast、grok-imagine-video-1.5、grok-imagine-video-1.5-lite）。快速开始
- 文生视频 API — 纯文本生成视频
- 首帧生视频 API — 指定视频开头
- 尾帧生视频 API — 指定视频结尾
- 首尾帧生视频 API — 同时指定首尾帧
- 关键帧生视频 API — 在视频中间插入关键帧
- 参考生视频 API — 使用参考图和语音角色
- Fetch API（获取结果） — 轮询异步任务结果
- Video 计费说明
核心功能
🎬 AI 视频生成
使用最新 Grok 模型从文本提示生成高质量视频，支持多种时长档位和分辨率选择。⚡ 异步工作流
异步提交生成任务，通过轮询或 Webhook 回调获取结果，适合生产环境集成。🎯 关键帧精确控制
通过keyframes 参数在视频中间指定关键帧图像，可与 first_frame 和 last_frame 组合使用。每个请求最多支持 4 个关键帧。
️ 首尾帧锁定
通过first_frame 和 last_frame 严格指定视频的开头和结尾图像。当首尾帧传入同一张图片时，可实现循环效果（loop）。
参考图与语音角色
通过refer_images 传入参考图片（最多 7 张），或通过 reference_audios 传入语音角色控制视频中的人物声音特征。
模型差异
说明：
grok-imagine-video-1.5-fast和grok-imagine-video-1.5支持所有高级控制功能grok-imagine-video-1.5-lite为轻量级模型，仅支持基础的文生视频功能
鉴权与基础地址
完整设置说明请参考 网关与鉴权。
端到端示例
第一步 — 提交生成请求
第二步 — 保存 jobId
第三步 — 获取生成结果
videoUrl 等完整信息。
全部接口列表
常见工作流
为什么选择 TTAPI
- 统一网关 — 通过单一 API Key 访问 Grok 及其他 AI 模型
- 持续跟进最新模型 — 始终支持最新 Grok 版本
- 标准化异步工作流 — 一致的任务提交、Fetch 轮询和 Webhook 回调模式
- 清晰文档结构 — 概览指南与端点参考分离
- 统一计费 — 跨所有 AI API 的统一配额管理
常见问题
应该用哪个 Grok 模型？
- grok-imagine-video-1.5-fast：适合需要快速生成且需要高级控制（关键帧、首尾帧）的场景，支持更长的输入文本
- grok-imagine-video-1.5：标准质量，平衡速度与质量，支持所有高级功能
- grok-imagine-video-1.5-lite：轻量级，性价比高，仅支持基础文生视频
如何控制视频的首尾帧？
使用 首尾帧生视频 API，同时传入first_frame 和 last_frame 参数。当两者传入同一张图片时，可实现循环效果（loop）。
如何在视频中间插入关键帧？
使用 关键帧生视频 API，通过keyframes 参数传入关键帧数组。每个关键帧包含 image_url 和 timestamp_s（时间戳）。每个请求最多支持 4 个关键帧。
如何使用参考图或语音角色？
使用 参考生视频 API，通过refer_images 传入参考图片数组（最多 7 张），或通过 reference_audios 传入语音角色数组。
如何查询任务状态？
使用 Fetch API 传入jobId 轮询状态。处理中时 status 返回 ON_QUEUE；完成后 status 返回 SUCCESS，响应中包含完整的视频 URL。
Grok 视频 API 支持 Webhook 吗？
支持。提交任何 Grok 任务时传入hookUrl 参数，TTAPI 会在任务完成后通过 HTTP POST 将结果推送到你的端点，无需轮询。