图片 / Grok 与其他模型
Grok Image 2.0
Grok Imagine 图片模型，推荐 grok-imagine-image-2.0，走 OpenAI Images 接口；旧文档覆盖的是已验证的图生图（参考图编辑）流程。用 aspect_ratio 控制画幅、resolution 控制档位，size 不保证锁定实际像素。按张计费 $0.035。
分组 #128「【Grok 生图】Grok Image 2.0」 · Key 需属于该分组
图生图多比例1K / 2KURL 返回Base64 返回
价格—
24 小时成功率—
最近 24 小时
可用模型
| 模型 | 说明 | 价格 |
|---|---|---|
grok-imagine-image | 兼容名称，映射到 grok-imagine-image-2.0；按张 $0.035 | — |
grok-imagine-image-2.0 | 推荐；文档全部参数测试使用此模型；按张 $0.035 | — |
grok-imagine-image-quality | 兼容名称，映射到 grok-imagine-image-2.0；按张 $0.035 | — |
接口
POST /v1/images/edits | 图生图：JSON images[].image_url（HTTPS 或 Data URL），或 multipart 重复上传 image |
GET /v1/models | 用同一把 Key 查询当前分组可用的完整模型名 |
能力与限制
| 计费方式 | 按张 $0.035（分组倍率 1） |
| 参考图 | 分组说明：最多 5 张；旧文档（2026-09）实测 1–3 张，4 张及以上返回 400 |
| 输出张数 | 分组说明：每次生成 1 张；旧文档实测 n=1–10 |
| 分辨率 | resolution 小写 1k / 2k（大写 2K 返回 422）；分组说明另列 1.5K |
| 比例 | 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、auto |
| quality | low / medium / auto，省略等同 medium；high 返回 400 |
| 实际像素（2026-09-15） | 1:1 为 1024×1024 JPEG（1k）/ 2048×2048 PNG（2k）；16:9 为 1280×720 JPEG / 2816×1584 PNG；auto 尺寸会变化 |
| 返回格式 | b64_json 或 url；不承诺统一的 URL 有效期 |
| 超时建议 | 示例 300 秒 |
请求参数
| 字段 | 类型 | 说明 | |
|---|---|---|---|
model | string | 必填 | 推荐 grok-imagine-image-2.0 |
prompt | string | 必填 | 清楚描述编辑目标及每张参考图用途；空字符串返回 400，省略返回 422 |
images | array | 可选 | JSON 参考图：[{"image_url": "URL 或 Data URL"}]；Base64 必须带 data:image/...;base64, 前缀 |
image | file | 可选 | multipart 参考图，重复上传同名字段 |
aspect_ratio | string | 可选 | 画幅比例，见限制表；auto 的实际画幅会变化 |
resolution | string | 可选 | 小写 1k 或 2k，推荐显式填写 |
quality | string | 可选 | 调试用 low，正式编辑起点 medium；可选 low / medium / auto |
n | integer | 可选 | 输出张数，调试先用数字 1 |
response_format | string | 可选 | 推荐 b64_json；url 时需另行下载 |
size | string | 可选 | 推荐省略；实际像素不按 size 锁定 |
output_format | string | 可选 | 推荐省略；1K 下 png / jpeg / webp 都返回 JPEG |
注意事项
- 推荐起点：单张 PNG、aspect_ratio=1:1、resolution=1k、quality=low、n=1、response_format=b64_json。
- 裸 Base64 在正确字段下也返回 400，Data URL 必须带 data:image/png;base64, 等完整前缀。
- 官方风格 images[].url、顶层 image:{"url": …} 在旧文档实测中返回 400，示例统一使用 images[].image_url。
- background=transparent 实测仍返回 JPEG，未得到透明输出；seed、mask、style、流式响应等不在已确认支持范围内。
- 保存时按文件头判断 PNG / JPEG 扩展名，不能按请求的 output_format 命名。
- 下载 URL 时使用明确的应用 User-Agent，不向图片域名发送本站 API Key；默认 Python User-Agent 曾触发上游 403 / 1010。
- 生成返回 200 但图片下载 403 时，图片已生成，先修复下载请求，不要直接重复生成。
- 多图排版请在提示词中说明布局并人工检查，三参考图实测曾多出一个空白格。
常见错误
| 返回 | 原因与处理 |
|---|---|
401 / 403 | Key 错误、已禁用或未绑定该分组；检查 Authorization: Bearer 请求头、绑定分组和访问权限。 |
400 Generated image rejected by content moderation. | 提示词、参考图或生成结果触发内容安全审核；修改描述或更换参考图后重试。 |
451 内容审计命中风险规则，请调整输入后重试 | 输入命中风险规则；调整提示词或参考图后重试。 |
400 xAI upstream returned status … | 参数不被上游接受；检查 resolution 用小写 1k / 2k、quality 不传 high、参考图数量、比例在支持列表内。 |
400 | 先看 JSON 字段名、数组结构、n 类型和必需参数。 |
422 | 检查大小写与枚举值，恢复已验证的 low / medium、1k / 2k 和明确比例。 |
502 且上游 403 / 1010 | 检查请求 User-Agent 和上游访问状态。 |
超时 / 503 | 先核对用量记录，等待通道恢复，再提交单图基线；不要连续重试相同大请求。 |