Grok Imagine 图像生成 (文生图 / 图生图)

xAI Grok Imagine 图像生成, OpenAI 兼容接口. 支持文生图 (t2i) 与图生图 (i2i).

POST /v1/images/generations

## Grok Imagine 图像生成 xAI Grok Imagine 系列图像模型, 走标准 OpenAI 图像接口 `POST /v1/images/generations`, 用 OpenAI SDK 0 改代码即可调用. **模型** - `grok-imagine-image` — 标准图像生成 - `grok-imagine-image-quality` — 高质量档 (更高分辨率与细节) **文生图 (t2i)**: 只传 `prompt`。 **图生图 (i2i)**: 额外传 `image` 字段 (参考图)。⚠️ `image` 必须是对象 `{"url": "https://..."}`, **不能传裸字符串 URL** (否则返 400)。响应为 OpenAI 兼容格式, 图像数据在 `data[].b64_json` (base64) 或 `data[].url`。

Request body

`model`	string	required	图像模型 ID
`prompt`	string	required	文本描述, 支持中英文; 描述越具体生成质量越高
`n`	integer		生成图片数量
`size`	string		图像尺寸 (宽×高)
`quality`	string		质量档位; `grok-imagine-image-quality` 走高质量档 (更高分辨率)
`image`	object		图生图 (i2i) 参考图。⚠️ 必须是对象 `{"url": "https://..."}`, 不能传裸字符串。仅图生图时需要。

Responses

200 — 成功返回生成图像 (OpenAI 兼容)
400 — 请求参数错误 (如 image 传了裸字符串而非 {"url"} 对象)
402 — 余额不足

Example

# 文生图 (t2i)
curl https://api.router.ai/v1/images/generations \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image",
    "prompt": "赛博朋克风格的城市夜景, 霓虹与雨水倒影",
    "size": "1024x1024",
    "n": 1
  }'

# 图生图 (i2i) — image 必须是 {"url":...} 对象
curl https://api.router.ai/v1/images/generations \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image",
    "prompt": "把这张图改成水彩画风格",
    "image": { "url": "https://example.com/photo.jpg" }
  }'

API reference