跳转到主要内容
POST
生成图片
创建图像任务。返回 { "taskId": "..." }。用 获取任务结果 轮询,直到 status 为 completed。
仅当 model 为 grok-imagine-image-2.0 时才会把 quality 传给上游,其他模型忽略该字段。

模型

请求

宽高比

2:3 3:2 1:1 9:16 16:9 4:3 3:4 2:1 1:2 19.5:9 9:19.5 20:9 9:20 21:9 5:2 auto

示例

图生图(不传 aspectRatio 时尺寸跟随第一张参考图):

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
prompt
string
必填

图片描述提示词(最大 5000 字符)

Maximum string length: 5000
示例:

"a cute cat sitting on a windowsill"

model
enum<string>
必填

图片模型

可用选项:
grok-imagine-image,
grok-imagine-image-quality,
grok-imagine-image-2.0
示例:

"grok-imagine-image"

n
number
默认值:1

生成张数,1–10。不传则生成 1 张(与现网一致)

必填范围: 1 <= x <= 10
aspectRatio
enum<string>

图片宽高比。不传则由模型自行决定(官方 auto)

可用选项:
2:3,
3:2,
1:1,
9:16,
16:9,
4:3,
3:4,
2:1,
1:2,
19.5:9,
9:19.5,
20:9,
9:20,
21:9,
5:2,
auto
resolution
enum<string>

图片分辨率,1k / 2k。不传则走官方默认 1k

可用选项:
1k,
2k
quality
enum<string>

生成质量,仅 grok-imagine-image-2.0 支持。不传则不向官方传该字段

可用选项:
low,
medium,
auto
images
string[]

参考图片 URL(图生图 / 编辑图片,最多 5 张)。不传 aspectRatio 时输出尺寸跟随第一张参考图;传入则覆盖

Maximum array length: 5

响应

200 - application/json
taskId
string
必填

任务 ID,用于后续查询结果