> ## 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 已下架，请改用 grok-imagine-image-2.0

> 老张API已下架 Grok Imagine 旧模型 grok-imagine-image，继续调用会返回 503。改用 grok-imagine-image-2.0 只需修改 model，比例和多参考图编辑的写法不变。

2026 年 10 月 30 日起，Grok Imagine 旧模型 `grok-imagine-image` 已下架，继续调用会返回 503。迁移只需改模型 ID，接口地址和请求格式不变。

* **发布日期**：2026 年 10 月 30 日
* **最后核对**：2026 年 10 月 30 日
* **当前状态**：已下架

## 关键信息

| 项目 | 内容 |
| - | - |
| 下架模型 | `grok-imagine-image` |
| 下架时间 | 2026 年 10 月 30 日 |
| 调用现象 | HTTP 503，提示 `no available channels for model grok-imagine-image` |
| 推荐替换 | `grok-imagine-image-2.0` |
| 接口 | 不变：`POST /v1/images/generations`、`POST /v1/images/edits` |
| 替换模型价格 | \$0.055/张，`1k`、`2k` 同价，按成功输出的图片张数计费 |

## 谁受影响

| 范围 | 内容 |
| - | - |
| 受影响 | `model` 为 `grok-imagine-image` 的生成和编辑请求 |
| 不受影响 | `grok-imagine-image-2.0`、`grok-imagine-image-quality`，以及其他图像模型 |

## 怎么迁移

**1. 修改模型 ID**

把请求里的 `model` 从 `grok-imagine-image` 改为 `grok-imagine-image-2.0`，末尾的 `.0` 不能省略。

**2. 按需加上分辨率和质量**

`aspect_ratio` 和多参考图编辑（最多 3 张）的写法不变。2.0 另外支持两个可选参数：

* `resolution`：`1k` 或 `2k`，不传时为 1K
* `quality`：`low` 或 `medium`

**3. 核对费用**

2.0 每张 \$0.055，旧模型为 \$0.025。成本敏感的批量任务可以在[图像生成总览](https://docs.laozhang.ai/api-capabilities/image-generation-guide.md)里比较其他模型。

## 常见问题

### 为什么下架？

`grok-imagine-image` 是 Grok Imagine 的上一代模型，xAI 推荐新接入使用 `grok-imagine-image-2.0`。老张API不再单独提供旧模型。

### 下架后调用会扣费吗？

不会。请求在分配线路前就返回 503，不产生费用。

### `grok-imagine-image-quality` 也下架了吗？

没有，目前仍可调用。xAI 计划 2026 年 11 月 2 日退役这个模型，建议同时迁移到 `grok-imagine-image-2.0`，并显式设置 `quality`。

## 相关链接

* [Grok Imagine Image API 接入文档](https://docs.laozhang.ai/api-capabilities/grok-imagine-image.md)：2.0 的参数、比例、分辨率和编辑示例。
* [图像生成总览](https://docs.laozhang.ai/api-capabilities/image-generation-guide.md)
* [模型与价格总表](https://docs.laozhang.ai/models.md)
* [老张API最新公告](https://docs.laozhang.ai/changelog.md)


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