直接答案：Grok 视频 API 是异步接口：先创建任务并保存 request_id，再轮询状态，完成后下载 MP4。适合文生视频和图生视频工作流；客户端必须设置业务超时、有限轮询，并用同一 API Key 查询任务。
1. Grok 视频 API 的异步流程
视频生成不是一次请求直接返回完整文件。客户端先调用 POST /v1/videos/generations，保存返回的 request_id，再调用状态接口；状态完成后读取 video.url 或请求 content 下载。
| 阶段 | 端点或动作 | 必需信息 | 成功标志 |
|---|---|---|---|
| 创建任务 | POST /v1/videos/generations | model、prompt，按需提供时长与分辨率 | 响应包含 request_id |
| 轮询状态 | GET /v1/videos/generations/REQUEST_ID | 原任务 ID 与同一 API Key | status 进入完成状态 |
| 下载视频 | 读取 video.url 或请求 /content | 完成任务的 ID | 获得可播放的 MP4 内容 |
任务提示：请使用提交任务的同一个 API Key 查询状态和下载内容，模型与权限以该密钥分组为准。
2. 创建 Grok 视频任务
curl https://www.codex789.com/v1/videos/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-video",
"prompt": "海边日落，镜头缓慢向前推进",
"duration": 6,
"resolution": "480p",
"aspect_ratio": "16:9"
}'服务会返回任务标识。客户端应保存 request_id，不要把它当成最终视频 URL。
3. 轮询状态并下载视频
查询任务：
curl https://www.codex789.com/v1/videos/generations/REQUEST_ID \
-H "Authorization: Bearer YOUR_API_KEY"
# 完成后下载
curl -L https://www.codex789.com/v1/videos/generations/REQUEST_ID/content \
-H "Authorization: Bearer YOUR_API_KEY" -o output.mp4状态响应可能包含 status、progress 和 video.url。客户端应对处理中状态进行有限间隔轮询，并对 failed、error、canceled 等终态停止重试。
4. Grok 视频模型与费用
Sub2API 默认模型映射包括 grok-imagine-video 和 grok-imagine-video-1.5。视频通常按分辨率与输出秒数计费，实际价格还会受到分组倍率和 API Key 配置影响。
- 基础视频模型：适合文生视频任务。
- 1.5 模型：支持图生视频方向，需提供首帧图片。
- 可选 480p、720p、1080p，具体可用档位以模型广场为准。
不要用文字模型 Token 价格推算视频价格，最终扣费以控制台记录为准。
5. Grok 视频生成 API FAQ
为什么创建接口很快返回但视频还没生成？
创建接口只提交异步任务，必须继续轮询状态，直到任务进入完成状态。
视频任务一直处理中怎么办？
检查请求 ID、API Key、分组权限和轮询间隔；超过业务超时时间后记录任务 ID并联系支持人员。
Grok 视频接口支持编辑和延长吗？
Sub2API 路由还提供 /v1/videos/edits 与 /v1/videos/extensions，具体模型和输入要求以当前控制台为准。