> ## 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 旧型号图像 API（grok-imagine-image）：价格与接入

> 说明 Grok Imagine 旧型号 grok-imagine-image 与 grok-imagine-image-quality 的价格、5 种宽高比、参考图数量与调用方法；新接入可先评估 grok-imagine-image-2.0。

`grok-imagine-image` 与 `grok-imagine-image-quality` 是 Grok Imagine 的旧型号图像模型，2026 年 8 月 13 日在老张API上线，目前仍可通过 Images API 调用；已有集成无需立即迁移。

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

<Info>
  **价格调整：** `grok-imagine-image` 上线时为 \$0.02/张，2026 年 9 月 3 日起调整为 \$0.025/张；`grok-imagine-image-quality` 仍为 \$0.045/张。两款模型都按成功生成的图片张数计费。
</Info>

## 关键事实

| 项目 | 旧型号说明 |
| - | - |
| 标准模型 | `grok-imagine-image` |
| 高质量模型 | `grok-imagine-image-quality` |
| 新款模型（另一型号） | `grok-imagine-image-2.0`，2026 年 9 月 3 日起提供；新接入建议先阅读 [Grok Imagine Image 2.0 上线公告](/announcements/grok-imagine-image-2-0-2026-09)和 [Grok Imagine Image API 接入指南](/api-capabilities/grok-imagine-image) |
| 宽高比 | `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` |

三个模型 ID 相互独立，不能混用：旧型号不带版本号，新款写作 `grok-imagine-image-2.0`（末尾有 `.0`）。

xAI 官方文档列出了更多宽高比，并使用自己的价格表；老张API为旧型号支持的比例只有上表 5 种，售价以[老张API控制台](https://api.laozhang.ai/account/pricing)和调用日志为准。

“单次最多 10 张”指 `n` 的输出图片数量，不是参考图输入上限。

## 谁适合继续使用旧型号

* 已接入 `grok-imagine-image` 或 `grok-imagine-image-quality`，效果与成本满足要求的项目；
* 需要一次提交 4 张参考图的工作流：旧标准模型支持 1–4 张，`grok-imagine-image-2.0` 最多 3 张；
* 需要低单价草稿或批量候选图的任务。

依赖 4K、mask 局部重绘、任意像素尺寸或固定 `seed` 复现的流程，不应假设旧型号支持这些能力。需要 15 种固定宽高比等新能力时，请评估 `grok-imagine-image-2.0`。

## 如何调用

<Steps>
  <Step title="确认令牌分组与价格">
    打开[控制台模型价格](https://api.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>

最小文生图请求（下载图片需要安装 `jq`）：

```bash theme={null}
export LAOZHANG_API_KEY="替换为你的老张API密钥"

curl -s https://api.laozhang.ai/v1/images/generations \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image",
    "prompt": "一张极简咖啡产品海报，暖色棚拍光线",
    "n": 1,
    "aspect_ratio": "1:1",
    "resolution": "1k",
    "response_format": "url"
  }' -o response.json

# 返回的 URL 是临时地址，及时下载保存
curl -s -o grok-image.jpg "$(jq -r '.data[0].url' response.json)"
```

请求结构、Python SDK、参考图编辑与错误处理见 [Grok Imagine Image API 接入指南](/api-capabilities/grok-imagine-image)；旧型号的宽高比与参考图数量以本页为准。

## 常见问题

### 旧型号的正确模型 ID 是什么？

`grok-imagine-image` 和 `grok-imagine-image-quality`，都不带版本号。新款模型是 `grok-imagine-image-2.0`，价格与参数范围不同，三者不能混用。

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

按成功生成的图片张数计算，单价见页首的价格调整说明；`n=10` 时会产生最多 10 张的费用。实际扣费以控制台调用日志为准。

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

同一模型的 1K 与 2K 同价。价格可能调整，批量调用前请复核控制台。

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

这 5 种是老张API为旧型号支持的比例。xAI 文档列出的其他比例不在旧型号的支持范围内；需要更多固定比例时，可评估支持 15 种固定宽高比的 `grok-imagine-image-2.0`。

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

使用 `/v1/images/edits`，并通过 `multipart/form-data` 上传：

* 字段：单图字段可用 `image`，多图重复 `image[]`。
* 数量：`grok-imagine-image` 支持 1–4 张，`grok-imagine-image-quality` 支持 1–2 张。

文生图仍使用 `/v1/images/generations` 的 JSON 请求。

### 旧型号需要迁移到 2.0 吗？

不需要立即迁移，旧型号仍可调用。需要 2.0 的新能力时，先用相同提示词各生成一张，比较质量与成本后再决定；依赖 4 张参考图的流程要注意 2.0 最多支持 3 张。

## 证据来源与相关文档

* [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 Image 2.0 上线公告](/announcements/grok-imagine-image-2-0-2026-09) — 新款模型的价格、参数与三图编辑
* [Grok Imagine Image API 接入指南](/api-capabilities/grok-imagine-image) — 接口、代码与错误处理
* [图像 API 选型与价格](/api-capabilities/image-generation-guide) — 与其他图像模型比较
* [老张API控制台](https://api.laozhang.ai/account/pricing) — 当前可用分组、价格与实际扣费


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.