> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

> 2026 年 9 月 3 日老张API开放 grok-imagine-image-2.0：每张 0.055 美元，支持 1K/2K、Low/Medium、最多 10 张输出和三参考图 multipart 编辑。

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

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

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

## 关键事实

| 项目      | 当前结论                               |
| ------- | ---------------------------------- |
| 模型 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/成功输出图片**                 |

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

## 谁需要关注

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

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

## 你需要做什么

<Steps>
  <Step title="确认模型与价格">
    在[模型价格页面](https://api2.laozhang.ai/account/pricing)确认令牌可以看到 `grok-imagine-image-2.0`，并核对当前单价仍为 \$0.055。
  </Step>

  <Step title="先生成一张图片">
    使用 `n=1`、1K、Low 完成首次调用，下载图片并检查真实像素、内容和调用记录。
  </Step>

  <Step title="按需增加参数">
    再测试生产所需的 2K、Medium、目标宽高比、批量数量或参考图编辑，不要直接从最大批量开始。
  </Step>
</Steps>

最小文生图请求：

```bash theme={null}
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 接入指南](/api-capabilities/grok-imagine-image)。

## 三参考图编辑

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

```bash theme={null}
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，并确认三种参考内容都影响了结果。

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

## 价格与计费

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

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

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

## 已知边界

* `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 模型](https://docs.x.ai/developers/models/grok-imagine-image-2.0) — 官方模型 ID、分辨率与质量价格
* [xAI 图像生成文档](https://docs.x.ai/developers/model-capabilities/images/generation) — 官方画幅、质量、分辨率与批量参数
* [xAI 图像编辑文档](https://docs.x.ai/developers/model-capabilities/images/editing) — xAI 官方 JSON 编辑格式；与当前老张API multipart 方式不同
* [Grok Imagine Image API 接入指南](/api-capabilities/grok-imagine-image) — 老张API文生图、三图编辑、SDK、价格与错误处理
* [老张API模型与价格](https://api2.laozhang.ai/account/pricing) — 当前模型、分组与公开价格