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`。

请求体

`model`	string	required	影像模型 ID
`prompt`	string	required	文本描述, 支援中英文; 描述越具體生成品質越高
`n`	integer		生成圖片數量
`size`	string		影像尺寸 (寬×高)
`quality`	string		品質檔位; `grok-imagine-image-quality` 走高品質檔 (更高解析度)
`image`	object		圖生圖 (i2i) 參考圖。⚠️ 必須是物件 `{"url": "https://..."}`, 不能傳裸字串。僅圖生圖時需要。

响应

200 — 成功返回生成影像 (OpenAI 相容)
400 — 請求參數錯誤 (如 image 傳了裸字串而非 {"url"} 物件)
402 — 餘額不足

调用示例

# 文生图 (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 文件