Grok Imagine Video API 中转

1. Grok Imagine Video 是什么

Grok Imagine Video 是 xAI 面向视频生成的模型，模型代号 grok-imagine-video，能力标签为文生视频与异步任务：输入一段文本提示词，模型自主完成镜头运动与画面演绎，返回一段可直接使用的短视频。

它的核心特点：

• 文生视频：无需参考图片，直接用提示词描述场景、主体与运镜即可出片。
• 异步任务流：提交接口立即返回 request_id，生成过程不占用客户端连接，适合批量排队。
• 多档位输出：支持 resolution（480p / 720p / 1080p）、duration（时长秒数）、aspect_ratio（画幅比例）三个关键参数。
• OpenAI 兼容网关：经 island AI Coding 中转后使用统一 Base URL 与 sk-codex789- 前缀密钥，无需注册海外账号。

如果你手上已有静态图片想让画面动起来（产品图动效、老照片复活），应改用图生视频模型 grok-imagine-video-1.5，见文末选型对比。

2. 异步生成生命周期

与对话类接口不同，视频生成不会在一次 HTTP 响应里返回成片。完整生命周期分三步：

1. 提交任务：POST /v1/videos/generations，响应中的 request_id 是后续所有操作的凭证。
2. 轮询状态：GET /v1/videos/generations/{request_id}，响应包含 status、progress 与完成后的 video.url。
3. 下载成片：状态完成后，调用 /content 子路径将 MP4 流式保存到本地。

两个工程实践提醒：其一，轮询必须携带与提交时相同的 API Key——模型授权以密钥为准，换 Key 查询可能得到无权限响应；其二，收到终态错误时先检查提示词是否触发内容策略，再排查账户额度，最后联系支持并提供 request_id。

站内实测参考：一次典型任务从提交到成片约 26 秒完成；实际耗时随分辨率、时长档位与队列负载波动，请以自己账号的任务记录为准。

3. 适合哪些业务场景

社媒短视频与营销素材

用一段提示词快速产出 5–10 秒开场镜头或转场空镜，配合文案即可发布，省去拍摄成本，特别适合日更型的短视频运营团队。

电商产品动效展示

为商品主图补一段环绕、推近的光影动效视频，提升详情页停留时长；静态帧部分可用 Grok 图片生成先行产出，再进入视频环节形成流水线。

短剧与开场镜头素材

短剧、动漫混剪需要大量氛围镜头（雨夜街头、机舱窗外、赛博城市），逐条提示词批量生成候选片段，比素材库检索更贴合剧本设定。

批量创意 A/B 测试

广告投放前对同一卖点生成多条不同风格的候选视频做小流量测试；异步任务模式天然适合脚本化并发提交、集中收割结果的工作流。

4. 价格与计费说明

成本估算方法：先用低分辨率（480p）与较短时长试跑确认质量符合预期，再切换到目标档位批量生产，避免在高档位上反复试错造成浪费。

5. API 最小示例

以下三步对应上文生命周期。sk-codex789-your-api-key 替换为控制台生成的真实 Key；完整参数与错误码请参阅 Grok 视频生成 API 教程。

第一步：提交任务

curl https://www.codex789.com/v1/videos/generations \
  -H "Authorization: Bearer sk-codex789-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "霓虹雨夜街头，镜头缓缓向前推进",
    "duration": 6,
    "resolution": "480p",
    "aspect_ratio": "16:9"
  }'

第二步：轮询状态

curl https://www.codex789.com/v1/videos/generations/REQUEST_ID \
  -H "Authorization: Bearer sk-codex789-your-api-key"

响应中的 status 到达完成态后即可进行第三步；期间可依据 progress 向用户展示进度条。

第三步：下载成片

curl -L https://www.codex789.com/v1/videos/generations/REQUEST_ID/content \
  -H "Authorization: Bearer sk-codex789-your-api-key" \
  -o output.mp4

6. Grok 视频模型对比

选型建议：没有现成素材、追求从零创作，选 grok-imagine-video；已有确定视觉稿（如电商主图、海报），希望保留画面主体仅添加动态，选 grok-imagine-video-1.5 并提供首帧图片。两者的 Base URL、鉴权与轮询流程完全一致，切换只需更换 model 参数并增减首帧字段。若还需要配套静态物料，可搭配 Grok Imagine Image 使用同一套 Key 完成「生图 → 生视频」流水线。

7. 常见问题