图像(Image)
Grok 图片模型 API
Grok Imagine 图片模型(grok-imagine-image、2.0、quality、edit)的文生图与图片编辑接口、比例、分辨率、参考图和报错说明。
适用范围
本页介绍 Grok Imagine 图片模型。视频模型请参阅 Grok 视频 API。
接口选择
Grok 图片模型使用 OpenAI Images 兼容接口:
| 用途 | 请求方法 | 端点 |
|---|---|---|
| 文生图 | POST | /v1/images/generations |
| 图片编辑(图生图) | POST | /v1/images/edits |
不支持 /v1/chat/completions 和 /v1/responses。参考图只能通过 /v1/images/edits 传入,写在 /v1/images/generations 里会被忽略。
模型与能力
| 模型 | 分辨率 | 参考图 | 单次张数 | 计费 |
|---|---|---|---|---|
grok-imagine-image | 1K (默认) / 2Kaspect_ratio + resolution | 最多 3 张 (Data URI / 公网 URL / 本地文件) | 最多 10 张 | 按张 |
grok-imagine-image-2.0 | 1K (默认) / 2Kaspect_ratio + resolution | 最多 3 张 (Data URI / 公网 URL / 本地文件) | 最多 10 张 | 按张 |
grok-imagine-image-quality | 1K (默认) / 2Kaspect_ratio + resolution | 最多 3 张 (Data URI / 公网 URL / 本地文件) | 最多 10 张 | 按张 |
grok-imagine-edit等同于 grok-imagine-image-quality | 1K (默认) / 2Kaspect_ratio + resolution | 最多 3 张 (Data URI / 公网 URL / 本地文件) | 最多 10 张 | 按张 |
支持的比例:auto (默认) / 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 / 2:1 / 1:2 / 19.5:9 / 9:19.5 / 20:9 / 9:20 / 21:9 / 5:2
| 模型 | quality | response_format |
|---|---|---|
grok-imagine-image | 不支持 | b64_json / url |
grok-imagine-image-2.0 | low / medium / auto | b64_json / url |
grok-imagine-image-quality | 不支持 | b64_json / url |
grok-imagine-edit | 不支持 | b64_json / url |
- 四个模型都能文生图,也都能编辑图片。
grok-imagine-edit与grok-imagine-image-quality是同一个模型,输出效果一致。quality参数只对grok-imagine-image-2.0生效。- 按成功返回的张数计费,与分辨率、参考图张数无关。
实际可用模型以控制台返回的模型列表为准。
鉴权
Authorization: Bearer $API_KEY
Content-Type: application/json比例与分辨率
aspect_ratio:见上方能力表。默认auto,由模型根据提示词选择画幅,同一提示词每次的比例不一定相同;需要固定尺寸时请显式传入。resolution:1k(默认)或2k,不支持 4K。
各档位的输出像素(四个模型相同):
| 比例 | 1K | 2K |
|---|---|---|
| 1:1 | 1024x1024 | 2048x2048 |
| 16:9 | 1280x720 | 2816x1584 |
| 9:16 | 720x1280 | 1584x2816 |
| 4:3 | 1152x864 | 2368x1776 |
| 3:4 | 864x1152 | 1776x2368 |
| 3:2 | 1248x832 | 2496x1664 |
| 2:3 | 832x1248 | 1664x2496 |
| 2:1 | 1408x704 | 2912x1456 |
| 1:2 | 704x1408 | 1456x2912 |
| 19.5:9 | 1248x576 | 2912x1344 |
| 9:19.5 | 576x1248 | 1344x2912 |
| 20:9 | 1280x576 | 3200x1440 |
| 9:20 | 576x1280 | 1440x3200 |
| 21:9 | 1568x672 | 3136x1344 |
| 5:2 | 1600x640 | 3200x1280 |
- 1K 输出为 JPEG,2K 输出为 PNG,不能通过
output_format更改。 - 也可以用 OpenAI 习惯的
size(例如1024x1024),会自动换算:长边不超过 1024 按1k,超过按2k,比例取最接近的支持值,所以返回像素不一定等于请求的size。1536x1024、1792x1024都会按2k输出。 - 同时传
size和aspect_ratio/resolution时,以aspect_ratio/resolution为准。
文生图
curl https://api.88api.ai/v1/images/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-image",
"prompt": "雨夜霓虹灯下的东京街头,电影感,写实摄影",
"aspect_ratio": "16:9",
"resolution": "2k",
"n": 1
}'请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型名称。 |
prompt | string | 是 | 图片描述,不能为空。建议控制在几千字以内。 |
aspect_ratio | string | 否 | 画面比例,默认 auto。 |
resolution | string | 否 | 1k(默认)或 2k。 |
n | integer | 否 | 生成张数,1 至 10,默认 1。 |
response_format | string | 否 | b64_json(默认)或 url。选 url 时返回 88API 的图片链接。 |
quality | string | 否 | 仅 grok-imagine-image-2.0:low、medium、auto(默认,生成按 low、编辑按 medium)。medium 生成更慢。 |
style、seed、negative_prompt、background、output_format、stream 等参数会被忽略。
响应示例
{
"created": 1760000000,
"data": [
{ "b64_json": "/9j/4AAQ...", "mime_type": "image/jpeg" }
]
}响应不包含 revised_prompt。
图片编辑
JSON 请求(推荐,支持多张参考图)
单张参考图用 image,多张参考图用 images 数组,最多 3 张:
curl https://api.88api.ai/v1/images/edits \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-image-quality",
"prompt": "把第一张图中的人物放进第二张图的场景里,保持人物外貌不变",
"images": [
"data:image/png;base64,...",
"https://example.com/scene.jpg"
],
"resolution": "2k"
}'- 参考图可以是 Data URI 或公网可直接下载的 URL。Base64 必须带
data:image/...;base64,前缀。 - 支持 JPG、PNG、WebP,不支持 GIF、BMP。
- 不要把
image写成数组,也不要同时传image和images。 - 参考图按传入顺序编号,提示词里可以用「第一张」「第二张」指代。
- 不传比例时,输出比例跟随第一张参考图,分辨率默认
1k;可以用aspect_ratio、resolution覆盖。
multipart 上传(单张)
本地文件也可以用 multipart 上传,但每次只能传一张,单个文件不超过 20 MB:
curl https://api.88api.ai/v1/images/edits \
-H "Authorization: Bearer $API_KEY" \
-F "model=grok-imagine-image" \
-F "image=@input.png" \
-F "prompt=把背景换成海边日落" \
-F "aspect_ratio=1:1"需要多张参考图时请使用 JSON 请求。
限制
- 不支持
mask局部重绘,传入的遮罩会被忽略。 - 不支持流式输出和异步取结果。
- 输出图片带 C2PA 内容凭证(标记为 AI 生成),没有可见水印。
常见报错
| 场景 | HTTP | 返回信息 |
|---|---|---|
| 调用对话或 Responses 接口 | 400 | <模型> 是生图模型,不支持 <接口> 接口。请改用:POST /v1/images/generations, POST /v1/images/edits |
| 比例不支持 | 400 | 不支持的图片比例。支持:… |
分辨率不支持(例如 4k) | 400 | 不支持的图片分辨率。resolution 仅支持 1k 或 2k,请使用小写格式。 |
n 超出 1 至 10、prompt 为空、同时传 image 和 images、multipart 传多张图 | 400 | 上游拒绝了请求参数(invalid-argument),请检查模型名、调用接口和请求参数 |
| 参考图格式不支持、Base64 缺少前缀、URL 无法下载 | 400 | 参考图相关的错误提示 |
| 参考图超过 3 张 | 502 | Upstream request failed |
| 内容审核未通过 | 400 | 图片生成未通过内容安全审核,请修改提示词或参考素材后重试。 |
以上请求失败不扣费。