售价、可用模型以控制台和这把 Key 所属分组为准。本页只写调用方法，不写渠道内部价。

成功时 JSON 里应有 data[0].url 或 data[0].b64_json。只有 HTTP 200、没有图片内容，不算成功。返回的 URL 多半是临时链接，请尽快转存。

你这把 Key 实际能打哪些名字，以控制台或 GET /v1/models 为准。不要按别的站的模型名单补。

gpt-image-2

复制curl {BASE}/images/generations \
  -H "Authorization: Bearer 你的生图Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只坐在窗边的橘猫，暖光，写实",
    "size": "1024x1536"
  }'

Grok Imagine

复制curl {BASE}/images/generations \
  -H "Authorization: Bearer 你的生图Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image",
    "prompt": "A collage of London landmarks in a stenciled street-art style",
    "n": 1,
    "resolution": "2k",
    "aspect_ratio": "16:9"
  }'

Grok 不要传 size 或 quality。OpenAI SDK 的 images.generate() 常常默认带 size，会原样转到上游并失败。Grok 请用 extra_body 只传 resolution / aspect_ratio，或直接 POST JSON。

走 POST {BASE}/images/edits，必须是 JSON，不要用 OpenAI SDK 的 images.edit()（它走 multipart）。

复制curl {BASE}/images/edits \
  -H "Authorization: Bearer 你的生图Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-quality",
    "prompt": "Render this as a pencil sketch with detailed shading",
    "image": {"type":"image_url","url":"https://example.com/photo.png"},
    "resolution": "2k"
  }'

复制curl {BASE}/images/edits \
  -H "Authorization: Bearer 你的生图Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-quality",
    "prompt": "Show both subjects sitting together on the grass",
    "images": [
      {"type":"image_url","url":"https://example.com/a.jpg"},
      {"type":"image_url","url":"https://example.com/b.jpg"}
    ],
    "aspect_ratio": "3:2"
  }'

多图默认比例跟第一张，可用 aspect_ratio 覆盖。上一轮返回的图 URL 可以再送进下一轮继续改。

• 不要用 /v1/responses 或 /v1/chat/completions 生图。
• 不要把生图模型写进文本接口。
• 不要用文本 Key / 视频 Key 生图。
• Grok 不要传 size、quality。
• 编辑不要发 multipart。
• 参考图不要超过 3 张。

分辨率、时长、按次 / 按秒，以这把 Key 在控制台或视频目录里的卡片为准。本页不写内部渠道和对照站价格。

记下返回的 id 或 request_id。建议每 5–10 秒查一次，最长等 15 分钟。常见耗时 30 秒到 3 分钟。未完成就下载会失败。

请用 curl、SDK 或服务端直打。浏览器跨站探测会先发 OPTIONS，本站不开放第三方网页跨域，页面上的 Failed to fetch 不是 Key 没开。

以该 Key 视频目录卡片上的「生成方式」为准。没有卡片，不要按口头名单补能力。

• 卡片标「文生视频」：只传 prompt，不要传图。
• 卡片标「图生视频」：除 prompt 外再传 1 张图。
• Grok 图生标准字段：image: {"url":"https://..."} 或 data:image/jpeg;base64,...。
• Grok 当前常见调用名：grok-imagine-video、grok-imagine-video-1.5，以及带 480p / 720p / 1080p 的分档名。能同时文生还是图生，看卡片。
• 其它常见名（以你的分组为准）：sora-2 sora-2-pro veo-fast veo-3-1 seedance-2.0

文生视频

复制curl {BASE}/videos \
  -H "Authorization: Bearer 你的视频Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "ocean waves hitting rocks, cinematic",
    "duration": 8,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

图生视频

复制curl {BASE}/videos \
  -H "Authorization: Bearer 你的视频Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "the person turns slightly and smiles",
    "duration": 8,
    "resolution": "720p",
    "image": {"url":"data:image/jpeg;base64,..."}
  }'

查状态 / 下载

复制curl {BASE}/videos/任务ID \
  -H "Authorization: Bearer 你的视频Key"

curl -o video.mp4 {BASE}/videos/任务ID/content \
  -H "Authorization: Bearer 你的视频Key"

• 不要用文本 Key 或生图 Key 打视频接口。
• 不要把视频模型写进 /v1/chat/completions、/v1/responses 或 /v1/images/generations。
• 创建失败就停，不要连续狂刷创建接口。
• Grok 不要传 size。
• 换 Key 后，旧任务会查不到。