> ## 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.

# GPT Image 2.5 API：官转与按次计费接入

> 接入 GPT Image 2.5 Flare 与 Sunburst，选择官转 token 计费或每次 0.03 美元的按次线路，查看模型 ID、分组、生成与编辑示例及网页版 2.5 说明。

`gpt-image-2.5-flare` 与 `gpt-image-2.5-sunburst` 官转已上线，接入方式沿用 `gpt-image-2` 官转的 Images API。优先速度选 **Flare**，优先精细图像编辑选 **Sunburst**；也可以在产品中提供两个选项，让用户自行选择。两者按 tokens 计费，token 单价与 `gpt-image-2` 官转相同。

按次计费可选择 `gpt-image-2.5-flare-vip` 和 `gpt-image-2.5-sunburst-vip`，均为 **\$0.03/次**，接入方式同 `gpt-image-2-vip`。

**更新日期：2026 年 9 月 9 日。**

## 先选择接入线路

| 线路      | 模型 ID                        | 令牌分组                    | 计费                             |
| ------- | ---------------------------- | ----------------------- | ------------------------------ |
| 官转      | `gpt-image-2.5-flare`        | `Sora2Official` 或企业官转分组 | 与 GPT Image 2 官转同 token 单价     |
| 官转      | `gpt-image-2.5-sunburst`     | `Sora2Official` 或企业官转分组 | 与 GPT Image 2 官转同 token 单价     |
| 按次计费    | `gpt-image-2.5-flare-vip`    | Default                 | \$0.03/次，接入同 `gpt-image-2-vip` |
| 按次计费    | `gpt-image-2.5-sunburst-vip` | Default                 | \$0.03/次，接入同 `gpt-image-2-vip` |
| 网页版 2.5 | `gpt-image-2-web`            | Default                 | 当前 \$0.03/次，以控制台为准             |

先确定线路和扣费类型，再复制对应示例。已有 GPT Image 2 集成可继续参考 [GPT Image 2 文档](/api-capabilities/gpt-image-2)。

## GPT Image 2.5 官转模型与分组

| 请求中的模型 ID                | 当前指向                                | 选择建议           |
| ------------------------ | ----------------------------------- | -------------- |
| `gpt-image-2.5-flare`    | `gpt-image-2.5-flare-2026-09-08`    | 更快的日常高质量生成     |
| `gpt-image-2.5-sunburst` | `gpt-image-2.5-sunburst-2026-09-08` | 更注重编辑精度的生成与图改图 |

一般接入使用不带日期的别名；需要固定版本时可使用表中的完整快照 ID。别名当前映射不代表未来永远固定。

1. 在[令牌管理](https://api2.laozhang.ai/token)选择按量计费，确认令牌允许调用目标模型。
2. 两个 2.5 模型使用**官转分组**。普通官转选择 `Sora2Official`；优先稳定性的生产调用选择企业官转分组 `GPTImage2 Sora2 Enterprise`。**Default 分组继续使用 `gpt-image-2-web`，对应 GPT 网页版最新的 2.5。**
3. 保留原有官转 Images API 的鉴权、请求结构和结果处理，将 `model` 改为上述别名或快照 ID。分组名不填入 `model`。

<Note>
  官转分组在控制台中对应 `Sora2Official` 和 `GPTImage2 Sora2 Enterprise`；接口配置中的分组键分别为 `sora_official` 和 `GPT_Image_2_Enterprise`。分组用于配置令牌，不填入请求的 `model`。Default 分组按次调用时，请使用带 `-vip` 后缀的模型 ID。
</Note>

## GPT Image 2.5 官转最小接入

以下示例沿用官转的文生图 `/v1/images/generations` 和图像编辑 `/v1/images/edits`。SDK 对应 `images.generate` 与 `images.edit`。

```bash theme={null}
export LAOZHANG_API_KEY="sk-你的按量令牌"
export BASE_URL="https://api2.laozhang.ai/v1"
```

### Flare 文生图

```bash theme={null}
curl --fail-with-body "$BASE_URL/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare",
    "prompt": "白色陶瓷杯的产品照片，灰色桌面，柔和自然光",
    "size": "1024x1024",
    "quality": "medium"
  }' -o generation.json
```

### Sunburst 图像编辑

先准备本地 `source.png`，再运行：

```bash theme={null}
curl --fail-with-body "$BASE_URL/images/edits" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -F "model=gpt-image-2.5-sunburst" \
  -F "image=@source.png" \
  -F "prompt=保留杯子的形状、构图和光照，只将杯身改为深蓝色。" \
  -F "size=1024x1024" \
  -F "quality=medium" \
  -o edit.json
```

两种模型均接受文本与图像输入；示例按各自侧重点选型，不表示 Flare 不能编辑或 Sunburst 不能生成。

<Info>
  官转接口参数参考 [OpenAI 图像生成指南](https://developers.openai.com/api/docs/guides/image-generation)。本页示例使用 Images API：生成调用 `/v1/images/generations`，编辑调用 `/v1/images/edits`。按次计费模型的质量选项见下文“尺寸与质量”，不要混用两种线路的参数范围。
</Info>

### 保存图片与查看结果

成功的 Images API 响应应包含图像结果。对于 `data[0].b64_json`，以下脚本将文生图结果保存为图片；编辑请求改读 `edit.json`：

```python theme={null}
import base64
import json
from pathlib import Path

response = json.loads(Path("generation.json").read_text())
value = response["data"][0]["b64_json"]
if value.startswith("data:"):
    value = value.split(",", 1)[1]
Path("output.png").write_bytes(base64.b64decode(value, validate=True))
```

打开 `output.png`，检查图片能否正常显示、实际尺寸是否符合请求；编辑时再检查要求保留的内容和指定改动。若线路返回 `data[0].url`，下载并打开该 URL 对应图片。随后在[调用日志](https://api2.laozhang.ai/log)核对模型、分组、usage 和实际扣费。

认证或模型权限错误先检查 Key、分组和模型 ID；参数错误按返回信息调整请求。若返回对象没有图片，保留脱敏错误和日志时间，按[Images API 参考](/api-reference/images)检查，联系支持时不要发送完整 Key。

## GPT Image 2.5 官转计费

两种 2.5 模型与 `gpt-image-2` 官转的 **token 单价相同**，按文本输入、图片输入和图片输出的实际用量计费。它们不采用旧按次线路的固定每次价格。

| 官方计费项  | 每 100 万 tokens 单价（美元） |
| ------ | --------------------- |
| 文本输入   | \$5                   |
| 缓存文本输入 | \$1.25                |
| 图片输入   | \$8                   |
| 缓存图片输入 | \$2                   |
| 图片输出   | \$30                  |

上表为 [OpenAI 官方 token 单价](https://developers.openai.com/api/docs/guides/image-generation#cost-and-latency)。老张API实际结算需结合[当前模型价格与令牌分组](https://api2.laozhang.ai/account/pricing)；企业报价联系支持团队确认。同价不等于单张图片总价相同，模型、尺寸、质量和参考图会影响 token 用量，应以代表性请求的 usage 估算。

## GPT Image 2.5 按次计费接入

新增 `gpt-image-2.5-flare-vip` 与 `gpt-image-2.5-sunburst-vip`，均为 **\$0.03/次**，接入方式和计费方式与 `gpt-image-2-vip` 一致。使用 **Default 分组的按次令牌**，确认令牌已开放目标模型。

| 模型 ID                        | 计费       | 接入方式                 |
| ---------------------------- | -------- | -------------------- |
| `gpt-image-2.5-flare-vip`    | \$0.03/次 | 沿用 `gpt-image-2-vip` |
| `gpt-image-2.5-sunburst-vip` | \$0.03/次 | 沿用 `gpt-image-2-vip` |

### 尺寸与质量

两个按次计费模型的文生图请求均可使用 `size` 和 `quality`。`quality` 使用 **`low`、`medium`、`high`**；**按次调用当前不支持 `xhigh` 和 `max`**，传入这两个值会返回 HTTP 400。不需要指定尺寸或质量时，省略相应字段即可。

| 参数        | 写法                        | 使用说明                         |
| --------- | ------------------------- | ---------------------------- |
| `size`    | `宽x高`，例如 `2048x2048`      | 需要确定输出尺寸时显式指定，可从下表选择常用规格     |
| `quality` | `low` / `medium` / `high` | 两款模型均支持这三档；可按任务选择，或提供三档选项给用户 |

两款按次计费模型均支持以下常用尺寸，可按画幅选择：

| 规格    | `size`      | 画幅   |
| ----- | ----------- | ---- |
| 1K 方图 | `1024x1024` | 1:1  |
| 横图    | `1536x1024` | 3:2  |
| 竖图    | `1024x1536` | 2:3  |
| 2K 方图 | `2048x2048` | 1:1  |
| 4K 横图 | `3840x2160` | 16:9 |
| 4K 竖图 | `2160x3840` | 9:16 |

<Tip>
  入门请求可以使用 `size="2048x2048"`、`quality="medium"`。`quality` 用于选择生成质量，两个模型仍按次计费；实际单价与扣费以[控制台](https://api2.laozhang.ai/account/pricing)为准。
</Tip>

**尺寸设置：** 非标准尺寸可能被自动调整，例如 `1023x1024` 可能返回 `1024x1024`。需要精确像素时，请使用上表中的标准尺寸，并检查返回图片的实际宽高。

### 文生图示例

已有 `gpt-image-2-vip` 集成时，保留 base URL、鉴权、接口和结果处理，将 `model` 替换为上表的完整 ID。以下示例生成一张 2K 方图，质量设为 `medium`：

```bash theme={null}
export LAOZHANG_API_KEY="sk-你的按次令牌"

curl --fail-with-body "https://api2.laozhang.ai/v1/images/generations" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare-vip",
    "prompt": "白色陶瓷杯的产品照片，灰色桌面，柔和自然光",
    "size": "2048x2048",
    "quality": "medium"
  }' -o generation.json
```

### 图像编辑示例

图像编辑使用 `/v1/images/edits`，沿用 `gpt-image-2-vip` 的 multipart 请求格式。先准备本地 `source.png`，再上传图片并描述需要修改的内容：

```bash theme={null}
curl --fail-with-body "https://api2.laozhang.ai/v1/images/edits" \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -F "model=gpt-image-2.5-sunburst-vip" \
  -F "image=@source.png" \
  -F "prompt=保留杯子的形状、构图和光照，只将杯身改为深蓝色。" \
  -o edit.json
```

两个按次计费模型使用同一种接入方式，可按需替换或让用户自选。图片保存方式同上；实际价格和扣费以[控制台](https://api2.laozhang.ai/account/pricing)及调用日志为准。

<Info>
  按次调用时必须保留模型名中的 `-vip` 后缀，例如 `gpt-image-2.5-flare-vip`。不带该后缀的 Flare / Sunburst 使用官转 token 计费。按次模型的 `quality` 请使用 `low`、`medium` 或 `high`。
</Info>

## Default 分组：gpt-image-2-web 已更新至网页版 2.5

Default 分组的网页版线路继续使用 `gpt-image-2-web`，对应 GPT 网页版最新的 2.5。已有这一路线的集成保留该模型 ID 即可，无需为了网页版更新改成 Flare 或 Sunburst。

`gpt-image-2-web` 是老张API的网页版线路模型名；它与 Flare / Sunburst 是不同接入线路，不应把网页版 2.5 等同于某个官转快照。当前公开价格目录列为 **\$0.03/次**，没有改为官转 token 计费；实际结算和参数范围以该线路控制台配置为准。

## 相关文档

* [GPT Image 2：已有集成](/api-capabilities/gpt-image-2)
* [Images API 参考](/api-reference/images)
* [图像生成 API 选择指南](/api-capabilities/image-generation-guide)
* [调用日志](/faq/call-logs)
* [模型与价格总表](/models)

## 参考资料

* [OpenAI Image generation](https://developers.openai.com/api/docs/guides/image-generation)
* [OpenAI GPT Image 2.5 Flare](https://developers.openai.com/api/docs/models/gpt-image-2.5-flare)
* [OpenAI GPT Image 2.5 Sunburst](https://developers.openai.com/api/docs/models/gpt-image-2.5-sunburst)
* [老张API当前模型与价格](https://api2.laozhang.ai/account/pricing)
* [GPT Image 2.5 上线公告](/announcements/gpt-image-2-5-2026-09)