Grok 图像

POST /v1/images/generations · POST /v1/images/edits

模型 grok-imagine-image-2.0，按张计费；上一代 grok-imagine-image-quality 同端点、同价、仍在线（官方定于 2026-11-02 退役）。 图生图不换模型：把生图模型送到 /v1/images/edits 就是改图。最后验证：2026-09-12。

基本调用

curl https://www.vibeapi.cn/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "a red apple on a wooden table, photo",
    "n": 1
  }'

from openai import OpenAI

client = OpenAI(base_url="https://www.vibeapi.cn/v1", api_key="YOUR_API_KEY")

result = client.images.generate(
    model="grok-imagine-image-2.0",
    prompt="a red apple on a wooden table, photo",
    n=1,
)
item = result.data[0]
print(item.url or "b64_json")   # 临时链接，生成后立即下载落盘

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://www.vibeapi.cn/v1", apiKey: "YOUR_API_KEY" });

const result = await client.images.generate({
  model: "grok-imagine-image-2.0",
  prompt: "a red apple on a wooden table, photo",
  n: 1,
});
const item = result.data[0];
console.log(item.url ?? "b64_json");   // 临时链接，生成后立即下载落盘

响应：

{
  "data": [{"url": "https://.../....jpeg", "mime_type": "image/jpeg"}],
  "usage": {"cost_in_usd_ticks": 600000000}
}

图片 URL 是临时地址，请在生成后立即下载落盘，不要直接交给终端用户或作为长期地址存储。

请求参数

画幅

grok-imagine-image-2.0 在本网关上只出 1248 × 832 一种尺寸：aspect_ratio 七种取值、resolution: 2k、quality 逐一试过， 既不报错也不生效。这与 xAI 官方文档（2.0 支持全部画幅与 2K）不一致，属本网关当前表现。

需要竖图、方图或任何非 3:2 画幅，用 grok-imagine-image-quality。它退役后由 2.0 以 quality: low 接管——如果届时 2.0 仍不认画幅，竖图就没有替代方案了。 上一代的尺寸口径也会变（9:16 曾返回 720 × 1280，现为 864 × 1152），不要把尺寸写死在代码里，以返回图片的实际宽高为准。

出图耗时

同一句提示词、同样单张：grok-imagine-image-2.0 36–64 秒，grok-imagine-image-quality 约 5 秒。 批量出图、或接在用户交互链路上的场景，按这个差距估算超时与并发。

图生图

curl https://www.vibeapi.cn/v1/images/edits \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "change the apple color to bright green, keep everything else identical",
    "image": {"type": "image_url", "url": "https://example.com/apple.jpg"}
  }'

只收 JSON body。 OpenAI SDK 的 images.edit() 走 multipart 表单上传，打到本网关会 502 （分组 auto 下模型 grok-imagine-image-2.0 的可用渠道不存在）。改图请自行 POST JSON，图片走 URL 或 base64 内联。

image 字段接受四种写法，都能正常出图、计费一致：

"image": {"type": "image_url", "url": "https://example.com/apple.jpg"}   // 文档写法
"image": {"url": "https://example.com/apple.jpg"}                       // 省略 type
"image": "https://example.com/apple.jpg"                                // 直接给字符串
"image": {"type": "image_url", "url": "data:image/jpeg;base64,...."}     // base64 内联

官方还支持一次最多 5 张源图（输出画幅默认跟随第一张，可用 aspect_ratio 覆盖）和 Files API 的 file_id；本网关输出仍固定 1248 × 832。 计费与文生图同档，按张；耗时 2.0 约 36–58 秒，上一代约 5 秒。

一致性

当前的改图更像「重画」而不是「编辑」：同一张红苹果原图、keep everything else identical，两代模型六次输出全部是按提示词重新绘制的新场景—— 苹果确实变绿了，但桌面、背景、道具、构图都换了。

对一致性有硬要求的链路（换色、局部替换、批量套版），先用自己的图跑一遍再上线。 把必须保留的元素直接写进提示词（背景、材质、机位、光线）比只写「保留其余部分」更有效；如果目标是「同一主体动起来」， 视频接口的 image（锁首帧）与 reference_images 反而更接近「保留原图」的语义。

在线调试

填入你自己的 API Key 即可直接发起请求，参数表与响应结构由接口定义生成。

模型填 grok-imagine-image-2.0，aspect_ratio 等 Grok 专有参数可在请求体里手动加。改图接口只收 JSON，通用调试器走 multipart，不适用，请直接用上文的 curl。

curl -X POST "https://www.vibeapi.cn/v1/images/generations/" \  -H "Content-Type: application/json" \  -d '{    "prompt": "string"  }'

{
  "created": 0,
  "data": [
    {
      "b64_json": "string",
      "url": "string"
    }
  ],
  "usage": {
    "total_tokens": 0,
    "input_tokens": 0,
    "output_tokens": 0,
    "input_tokens_details": {
      "text_tokens": 0,
      "image_tokens": 0
    }
  }
}

官方文档

• xAI · Image Generation · Image Editing · Multi-Image Editing