88API88API
使用指南AI 应用API 文档帮助支持
图像(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-image1K (默认) / 2K
aspect_ratio + resolution
最多 3 张 (Data URI / 公网 URL / 本地文件)最多 10 张按张
grok-imagine-image-2.01K (默认) / 2K
aspect_ratio + resolution
最多 3 张 (Data URI / 公网 URL / 本地文件)最多 10 张按张
grok-imagine-image-quality1K (默认) / 2K
aspect_ratio + resolution
最多 3 张 (Data URI / 公网 URL / 本地文件)最多 10 张按张
grok-imagine-edit
等同于 grok-imagine-image-quality
1K (默认) / 2K
aspect_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

模型qualityresponse_format
grok-imagine-image不支持b64_json / url
grok-imagine-image-2.0low / medium / autob64_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。

各档位的输出像素(四个模型相同):

比例1K2K
1:11024x10242048x2048
16:91280x7202816x1584
9:16720x12801584x2816
4:31152x8642368x1776
3:4864x11521776x2368
3:21248x8322496x1664
2:3832x12481664x2496
2:11408x7042912x1456
1:2704x14081456x2912
19.5:91248x5762912x1344
9:19.5576x12481344x2912
20:91280x5763200x1440
9:20576x12801440x3200
21:91568x6723136x1344
5:21600x6403200x1280
  • 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
  }'

请求参数

参数类型必填说明
modelstring是模型名称。
promptstring是图片描述,不能为空。建议控制在几千字以内。
aspect_ratiostring否画面比例,默认 auto。
resolutionstring否1k(默认)或 2k。
ninteger否生成张数,1 至 10,默认 1。
response_formatstring否b64_json(默认)或 url。选 url 时返回 88API 的图片链接。
qualitystring否仅 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 张502Upstream request failed
内容审核未通过400图片生成未通过内容安全审核,请修改提示词或参考素材后重试。

以上请求失败不扣费。