用 Grok 出图、出视频

把 llm.txt 粘贴给你的 Codex / GPT，它就能按本站接口写客户端，不必再从网页里摘字段。

先选对分组

网页最快路径

1. 1

   创建 Grok（Heavy）密钥

   控制台「API 密钥」→ 创建密钥 → 分组选 Grok（Heavy）。创建后只显示一次完整 Key，先复制保存。

2. 2

   打开在线生图

   侧栏点「在线生图」，或直接打开 /image-studio/。已登录时页面会自动读到这把 Key。

3. 3

   切换到 Grok Imagine

   顶部引擎选 Grok Imagine。没有 Heavy 密钥时这一侧会锁定，点进去会引导去创建，不会等到点「开始生成」才报错。

4. 4

   选模式再生成

   文生图 / 图生图 / 文生视频 / 图生视频。生图再选清晰度 1K / 2K / 4K。图生图和图生视频必须先上传参考图。视频再选分辨率和 1–15 秒时长。

5. 5

   到使用记录核对

   生成完成后，控制台「使用记录」应出现 Grok（Heavy）密钥和 grok-imagine* 模型。这才算真正打到本站。

模型怎么填

API：文生图

不要传 OpenAI 的 quality。用 resolution 控制清晰度（1k / 2k / 4k），用 size 只供本站按 1K / 2K / 4K 计费（上游会剥掉 size）。

read -s GEILI_GROK_HEAVY_KEY
curl -sS https://image-direct.geiliapi.com/v1/images/generations \
  -H "Authorization: Bearer $GEILI_GROK_HEAVY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"grok-imagine","prompt":"一只坐在屋顶上看月亮的猫，电影感夜景","n":1,"resolution":"1k","size":"1024x1024"}'
unset GEILI_GROK_HEAVY_KEY

$secure = Read-Host "Grok Heavy API Key" -AsSecureString
$ptr = [Runtime.InteropServices.Marshal]::SecureStringToBSTR($secure)
$key = [Runtime.InteropServices.Marshal]::PtrToStringBSTR($ptr)
Invoke-RestMethod https://image-direct.geiliapi.com/v1/images/generations -Headers @{Authorization="Bearer $key"} -ContentType "application/json" -Body '{"model":"grok-imagine","prompt":"一只坐在屋顶上看月亮的猫，电影感夜景","n":1,"resolution":"1k","size":"1024x1024"}'
[Runtime.InteropServices.Marshal]::ZeroFreeBSTR($ptr)

API：图生图

用 multipart 上传参考图。字段名第一张是 image，更多参考图用 image[1]、image[2]。

curl -sS https://image-direct.geiliapi.com/v1/images/edits \
  -H "Authorization: Bearer $GEILI_GROK_HEAVY_KEY" \
  -F model=grok-imagine-edit \
  -F prompt="保持主体，把背景换成清晨的厨房" \
  -F image=@./reference.png

API：文生视频

视频是异步任务：先 POST /v1/videos/generations 拿到 request_id，再轮询 GET /v1/videos/{id}。完成后用返回的 video_url，或再取 /v1/videos/{id}/content。

curl -sS https://image-direct.geiliapi.com/v1/videos/generations \
  -H "Authorization: Bearer $GEILI_GROK_HEAVY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"grok-imagine-video","prompt":"海浪拍打礁石，慢镜头","resolution":"720p","duration":8}'

# 记下 request_id 后轮询，直到 status=completed / done / success
curl -sS https://image-direct.geiliapi.com/v1/videos/替换为request_id \
  -H "Authorization: Bearer $GEILI_GROK_HEAVY_KEY"

API：图生视频

参考图放在 image.url，可以是 https:// 或 data:image/...。建议分辨率 720p 或 1080p。

{
  "model": "grok-imagine-video-1.5",
  "prompt": "让画面里的人轻轻转头，头发随风动",
  "resolution": "1080p",
  "duration": 8,
  "image": {
    "url": "data:image/png;base64,替换为参考图"
  }
}

验证第一次请求

1. 1

   确认 Key 属于 Heavy

   控制台密钥列表的分组名应是 Grok（Heavy）。普通 Grok Key 调 Images / Videos 会 404 或提示该平台不支持。

2. 2

   网页先跑一张

   在线生图切到 Grok Imagine → 文生图 → 输入短提示词生成。成功后「使用记录」出现 grok-imagine。

3. 3

   API 先打匿名边界

   不带 Key 访问 https://image-direct.geiliapi.com/v1/images/generations 和 /v1/videos/generations 应返回 401。再带 Heavy Key 发上面的最小请求。

这个工具的故障