Grok Imagine Video 1.5 API 中转

1. Grok Imagine Video 1.5 是什么

Grok Imagine Video 1.5（调用代号 grok-imagine-video-1.5）是 xAI Grok Imagine 视频系列中的图生视频模型：以你提供的一张图片作为首帧起点，在保持画面主体、风格与构图一致的前提下生成一段短视频。

它的核心特点：

• 首帧可控：画面的主角、配色与构图由你的图片决定，模型负责让镜头与元素动起来，适合品牌视觉一致性要求高的场景。
• 与文生视频同一套流程：同样走 /v1/videos/generations 异步任务流，提交、轮询、下载三个步骤完全一致。
• OpenAI 兼容网关：经 island AI Coding 中转后使用统一 Base URL 与 sk-codex789- 前缀密钥，无需注册海外账号。

2. 图生视频还是文生视频

一句话决策：已经有确定的视觉稿（电商主图、活动海报、漫画分镜），要的是「这张图动起来」，选本页模型；还没有画面、想先看模型自由发挥，选文生视频。两者切换只影响提交参数，轮询与下载代码可完全复用。

3. 首帧图片怎么准备

首帧质量直接决定成片观感，准备时建议关注三点：

• 来源：可以用 Grok 图片生成或 GPT-image2 先产出静态图，也可以直接上传实拍图或设计稿，三者都能作为首帧输入。
• 清晰度与主体：主体清晰、边缘干净的图片动效更稳定；模糊、强压缩的图片会被放大瑕疵。
• 预留运镜空间：构图四周适当留白，给镜头推拉与元素运动留余地；主体顶满边框的画面动态幅度受限。

关于图片格式、大小上限等技术约束，以接口文档与控制台说明为准；若请求被拒绝，优先检查首帧文件本身是否满足要求。

4. 适合哪些业务场景

电商商品动效

把静态商品主图变成缓慢环绕、光影流动的展示视频，用于详情页与直播间贴片；主体由原图锁定，不会出现「货不对板」的变形风险。

海报与封面转视频

活动海报、课程封面、播客封面一键动态化，投放至开屏与信息流广告位，比静态素材获得更高的点击停留。

旧照与插画复活

老照片修复动态化、漫画分镜与插画作品集动态展示，为内容账号提供差异化的怀旧与艺术向素材。

批量内容矩阵生产

同一套设计稿批量生成不同运镜风格的短视频做 A/B 测试；异步任务模式适合脚本化并发提交、集中收割结果。

5. API 最小示例

流程与文生视频一致：向 /v1/videos/generations 提交任务时附带首帧图片，并将 model 设为 grok-imagine-video-1.5；首帧图片的具体传参字段名，以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-1.5",
    "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；出现终态 failed / error / canceled 时停止轮询并核对首帧与提示词。

第三步：下载成片

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

6. 价格与计费说明

成本控制技巧：先用一张代表性首帧在 480p 档位试跑确认运镜效果，锁定满意的提示词模板后再批量切换目标档位生产。

7. 常见问题