Grok Imagine 图像生成

基于 xAI Grok Imagine 系列的图像生成模型，支持文生图与图生图，输出 OpenAI 兼容格式。grok-imagine-image-2.0 支持 分辨率 × 质量 双维度定价。

端点

POST $URL/v1/images/generations

支持模型

模型	定位	分辨率	质量（quality）
grok-imagine-image	标准版，文生图 / 图生图	1k / 2k	—
grok-imagine-image-quality	高质量版	1k / 2k	—
grok-imagine-image-2.0	最新版，可控质量	1k / 2k	low / medium / auto

主要参数

参数	类型	必填	说明
model	string	是	上表中的模型名
prompt	string	是	图片描述
n	integer	否	生成数量 1–10，默认 1
resolution	string	否	1k（默认）/ 2k
quality	string	否	low / medium / auto，仅 grok-imagine-image-2.0 支持；auto 由服务端选择（生成当前按 low 计）
aspect_ratio	string	否	1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 21:9 等，默认 auto
image	string | object	否	图生图：参考图 URL / base64；多张参考可用 images 数组
response_format	string	否	url（默认，临时链接）/ b64_json

请求示例

文生图

curl

curl $URL/v1/images/generations \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "一只戴着墨镜的猫走在霓虹灯街道上",
    "n": 1,
    "resolution": "2k",
    "quality": "medium"
  }'

Python

from openai import OpenAI

client = OpenAI(api_key="YOUR_API_KEY", base_url="$URL/v1")
resp = client.images.generate(
    model="grok-imagine-image-2.0",
    prompt="一只戴着墨镜的猫走在霓虹灯街道上",
    n=1,
    extra_body={"resolution": "2k", "quality": "medium"},
)
print(resp.data[0].url)

图生图（带参考图）

curl $URL/v1/images/generations \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "把这张照片变成赛博朋克风格",
    "image": "https://example.com/photo.jpg",
    "resolution": "1k"
  }'

计费

按每张输出图计费（分辨率 × 质量），输入参考图按每张另计（与 xAI 官方价一致）：

模型	1K	2K	输入图
grok-imagine-image	$0.02/张	$0.02/张	$0.002/张
grok-imagine-image-quality	$0.05/张	$0.07/张	$0.01/张
grok-imagine-image-2.0	Low $0.04 / Medium $0.06	Low $0.06 / Medium $0.08	$0.01/张

计费示例：grok-imagine-image-2.0 生成 1 张 2K·Medium = $0.08；n=4 按 4 张输出计。

说明

• 结果 URL 为临时链接，请尽快下载保存（可用 response_format: "b64_json" 直接取 base64）；
• quality 缺省为 auto，由服务端按请求自动选择（当前生成按 low 计费）；
• 分组倍率另计，以上单价为基准货币价。