Grok Imagine Image 2.0 API 上线：$0.055 生图与三图编辑

发布日期：2026 年 9 月 3 日
最后核对：2026 年 9 月 3 日
当前状态：有效；已完成公开域名的文生图与三参考图编辑验证

老张API现已开放 grok-imagine-image-2.0。当前价格为 $0.055/成功输出图片，文生图支持 1K/2K、Low/Medium、15 种固定宽高比和单次最多 10 张输出；图片编辑通过 OpenAI 兼容的 multipart 接口上传 1–3 张参考图。

新模型 ID 必须完整写成 grok-imagine-image-2.0，包括末尾的 .0。旧模型 grok-imagine-image 与 grok-imagine-image-quality 继续可用，本次更新不要求现有调用立即迁移。

关键事实

项目	当前结论
模型 ID	`grok-imagine-image-2.0`
文生图	JSON `POST /v1/images/generations`
图片编辑	multipart `POST /v1/images/edits`
参考图数量	1–3 张
分辨率	`1k`、`2k`
质量	建议显式使用 `low` 或 `medium`
宽高比	15 个固定值
单次输出	`n=1–10`
返回形式	`url` 或 `b64_json`
老张API价格	$0.055/成功输出图片

当前编辑必须使用 multipart 文件上传。xAI 官方 JSON 图片对象、四张参考图和五张参考图不在本次开放范围内；不要把这些明确边界当成临时故障反复重试。

谁需要关注

需要比 xAI 当前官方最高文生图档位更低单价的开发者；
需要 1K/2K、Low/Medium 和多种横竖画幅的内容、广告或电商应用；
需要用两张或三张参考图组合主体、场景与风格的工作流；
已使用 OpenAI Python SDK，希望只替换 Base URL、API Key 与模型 ID 的团队。

依赖 xAI JSON 编辑、四图或五图输入、4K、mask 局部重绘、固定 seed 或自定义像素尺寸的应用不应直接迁移。

你需要做什么

确认模型与价格

在模型价格页面确认令牌可以看到 grok-imagine-image-2.0，并核对当前单价仍为 $0.055。

先生成一张图片

使用 n=1、1K、Low 完成首次调用，下载图片并检查真实像素、内容和调用记录。

按需增加参数

再测试生产所需的 2K、Medium、目标宽高比、批量数量或参考图编辑，不要直接从最大批量开始。

最小文生图请求：

curl "https://api2.laozhang.ai/v1/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "A cobalt-blue ceramic mug on pale stone, clean product photo, no text",
    "n": 1,
    "aspect_ratio": "1:1",
    "resolution": "1k",
    "quality": "low",
    "response_format": "url"
  }'

完整参数、Python SDK、15 种画幅和错误处理见 Grok Imagine Image API 接入指南。

三参考图编辑

多图编辑需要重复提交 image[]：

curl "https://api2.laozhang.ai/v1/images/edits" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -F "model=grok-imagine-image-2.0" \
  -F "prompt=Place the product from image 1 in the scene from image 2, and apply the style from image 3. Preserve the product colors." \
  -F "image[]=@product.png" \
  -F "image[]=@scene.jpg" \
  -F "image[]=@style.jpg" \
  -F "aspect_ratio=3:2" \
  -F "response_format=url"

上传顺序对应提示词中的 image 1、image 2、image 3。上线前验证在 api2.laozhang.ai 返回了可解码的 1248×832 JPEG，并确认三种参考内容都影响了结果。

当前最多三张参考图。第四张起应在客户端直接拒绝；已知超限请求可能返回 HTTP 500，不应自动重试。

价格与计费

计费单位是成功输出图片，不是 HTTP 请求次数：

请求	当前费用
`n=1`	$0.055
`n=4`	$0.220
`n=10`	$0.550
三参考图编辑并返回一张图片	$0.055

当前 1K/2K 与 Low/Medium 使用同一公开单价。价格可能随服务成本调整；批量调用前请复核控制台，并以调用记录为最终账单依据。服务与计费的一般规则以服务条款为准。

已知边界

quality="high" 不在允许范围内，客户端应提前拒绝；
resolution="4k" 不支持；
四张或五张参考图不支持；
xAI JSON 图片编辑格式当前不支持；
URL 返回是临时地址，应及时下载；
Medium 与 2K 的延迟可能明显高于 1K Low，生产硬超时建议 180 秒。

常见问题

$0.055 是每次请求还是每张图片？

按成功返回的图片张数计算。n=10 成功返回十张时是 $0.550；请求失败且没有生成结果时，应到调用记录确认实际扣费。

编辑最多支持几张参考图？

当前支持一至三张，并使用 multipart 文件上传。四张和五张暂不支持。

1K、2K、Low 与 Medium 是否同价？

当前老张API公开价格相同，均为 $0.055/成功输出图片。不同档位的延迟和服务成本不同，价格可能调整。

为什么不能直接使用 xAI 的 JSON 编辑示例？

因为老张API当前验证的是 OpenAI 兼容 multipart 上传。JSON 图片对象会返回 HTTP 400；请使用完整指南中的文件上传示例。

旧模型需要立即迁移吗？

不需要。grok-imagine-image 与 grok-imagine-image-quality 继续可用。只有当 2.0 的质量、画幅或三图编辑更适合任务时，再通过相同提示词小样决定是否迁移。

来源与相关文档

xAI Grok Imagine Image 2.0 模型 — 官方模型 ID、分辨率与质量价格
xAI 图像生成文档 — 官方画幅、质量、分辨率与批量参数
xAI 图像编辑文档 — xAI 官方 JSON 编辑格式；与当前老张API multipart 方式不同
Grok Imagine Image API 接入指南 — 老张API文生图、三图编辑、SDK、价格与错误处理
老张API模型与价格 — 当前模型、分组与公开价格

​关键事实

​谁需要关注

​你需要做什么

​三参考图编辑

​价格与计费

​已知边界

​常见问题

​$0.055 是每次请求还是每张图片？

​编辑最多支持几张参考图？

​1K、2K、Low 与 Medium 是否同价？

​为什么不能直接使用 xAI 的 JSON 编辑示例？

​旧模型需要立即迁移吗？

​来源与相关文档

关键事实

谁需要关注

你需要做什么

三参考图编辑

价格与计费

已知边界

常见问题

$0.055 是每次请求还是每张图片？

编辑最多支持几张参考图？

1K、2K、Low 与 Medium 是否同价？

为什么不能直接使用 xAI 的 JSON 编辑示例？

旧模型需要立即迁移吗？

来源与相关文档