> ## 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 2 图像 API 上线：双模型价格与接入指南

> 2026 年 8 月 13 日老张API上线 Grok Imagine 2：两款模型支持 5 种宽高比、1K/2K、最多 10 张输出与参考图编辑，并公布按模型区分的多图边界。

* **发布日期**：2026 年 8 月 13 日
* **最后核对**：2026 年 8 月 13 日
* **当前状态**：有效；具体可用分组和实时价格以控制台为准

老张API现已上线 xAI 当前一代 Grok Imagine 图像能力：`grok-imagine-image` 与 `grok-imagine-image-quality`。两款模型通过统一 Images API 提供 5 种已文档化宽高比、1K/2K、单次最多 10 张输出和参考图编辑；当前按张价格分别为 **\$0.02** 与 **\$0.045**。

<Info>
  产品名称写作 “Grok Imagine 2”，API 请求中的模型 ID 不带 `2`。完整请求、参数、编辑示例与上线验收见 [Grok Imagine 2 API 指南](/api-capabilities/grok-imagine-image)。
</Info>

## 关键事实

| 项目            | 当前结论                                   |
| ------------- | -------------------------------------- |
| 标准模型          | `grok-imagine-image`，\$0.02/张          |
| 高质量模型         | `grok-imagine-image-quality`，\$0.045/张 |
| 宽高比           | 当前文档化 `1:1`、`16:9`、`9:16`、`4:3`、`3:4`  |
| 分辨率           | `1k`、`2k`；当前同模型两档同价                    |
| 批量生成          | 单次 `n` 最多 10，按生成张数计费                   |
| 标准模型参考图编辑     | `/v1/images/edits`；支持 1–4 张            |
| Quality 参考图编辑 | `/v1/images/edits`；支持 1–2 张            |
| 文生图           | `/v1/images/generations`               |
| 返回格式          | `url` 或 `b64_json`                     |

<Warning>
  xAI 官方文档列出了更多宽高比，并使用其自己的官方价格表。老张API当前只承诺本公告列出的 5 个比例；老张API售价与 xAI 官网价不是同一计费合同。请以[老张API控制台](https://api2.laozhang.ai/account/pricing)和调用日志核账。
</Warning>

<Info>
  “单次最多 10 张”指 `n` 的输出图片数量，不是参考图输入上限。老张API参考图范围按模型区分：标准模型 1–4 张，Quality 1–2 张。
</Info>

## 谁需要关注

* 需要固定按张预算、1K/2K 批量出图的开发者；
* 希望单次请求生成多张候选图的内容、广告和电商团队；
* 需要用多张参考图进行主体保留、风格转换或组合，并能按模型处理不同输入上限的工作流；
* 正在从 GPT-Image、Flux 或其他 Images API 迁移，并需要 OpenAI SDK 兼容调用的团队。

不使用图像 API 的文本、语音与视频调用不受本次上线影响。依赖 4K、mask 局部重绘、任意像素尺寸或固定 `seed` 复现的流程，也不应直接假设可以迁移到本模型。

## 你需要做什么

<Steps>
  <Step title="确认令牌分组与价格">
    打开[控制台模型价格](https://api2.laozhang.ai/account/pricing)，确认目标令牌可见模型 ID 和当前单价。
  </Step>

  <Step title="选择标准或高质量模型">
    日常素材和 3–4 图组合使用 `grok-imagine-image`；成片或 1–2 图精细编辑可用 `grok-imagine-image-quality` 做同提示词小样对比。
  </Step>

  <Step title="完成一张验收图">
    先用 `n=1` 测试目标比例和分辨率，检查图片真实像素、内容、返回字段与扣费记录，再增加批量和并发。
  </Step>
</Steps>

最小文生图请求：

```bash theme={null}
curl https://api2.laozhang.ai/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image",
    "prompt": "一张极简咖啡产品海报，暖色棚拍光线",
    "n": 1,
    "aspect_ratio": "1:1",
    "resolution": "1k"
  }'
```

完整文生图、Python SDK、参考图编辑、多图融合、参数迁移与错误处理请使用站内唯一 owner：[Grok Imagine 2 API 图像生成与编辑](/api-capabilities/grok-imagine-image)。

## 常见问题

### Grok Imagine 2 的正确模型 ID 是什么？

正确 ID 是 `grok-imagine-image` 和 `grok-imagine-image-quality`，都不带 `2`。请勿把产品名称直接拼进模型 ID。

### 价格是每次请求还是每张图片？

按成功生成的图片张数计算。当前 `grok-imagine-image` 为 \$0.02/张，`grok-imagine-image-quality` 为 \$0.045/张；`n=10` 时会产生最多 10 张的费用。实际订单以控制台调用日志为准。

### 1K 与 2K 是否同价？

本次老张API上线价格中，同一模型的 1K 与 2K 同价。该规则可能随渠道和价格调整变化，批量调用前请复核控制台。

### 为什么公告只列 5 种宽高比？

这 5 种是老张API当前文档化的支持范围。xAI 上游文档列有更多比例，但上游能力不能自动证明当前老张API网关已经逐项验证并承诺支持。

### 参考图应该发到哪个端点？

使用 `/v1/images/edits`，并通过 `multipart/form-data` 上传：单图字段可用 `image`，多图重复 `image[]`。`grok-imagine-image` 支持 1–4 张，`grok-imagine-image-quality` 支持 1–2 张。文生图仍使用 `/v1/images/generations` 的 JSON 请求。

### 旧图像模型需要立即迁移吗？

不需要。本公告新增模型，不下线现有模型。只有当固定按张成本、单次多图或参考图编辑更符合任务时，才应通过同提示词小样测试后迁移。

## 证据来源与相关文档

* [xAI 多图编辑文档](https://docs.x.ai/developers/model-capabilities/images/multi-image-editing) — 上游多图编辑工作流与输入顺序
* [xAI Grok Imagine Image 标准模型](https://docs.x.ai/developers/models/grok-imagine-image) — 标准模型的图像输入能力
* [xAI 图像生成文档](https://docs.x.ai/developers/model-capabilities/images/generation) — 上游参数与响应格式
* [xAI 模型与价格](https://docs.x.ai/developers/pricing) — 上游官方价格；不等同于老张API售价
* [Grok Imagine 2 API 完整指南](/api-capabilities/grok-imagine-image) — 老张API接口、代码与验收
* [图像生成 API 选型指南](/api-capabilities/image-generation-guide) — 与其他图像模型比较
* [老张API控制台](https://api2.laozhang.ai/account/pricing) — 当前可用分组、价格与实际扣费