> ## 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 API > GPT-Image-2 开发指南，说明默认分组标准线路、gpt-image-2-vip 参数支持、Sora2Official 混合官方 API 转发分组，以及 GPTImage2 Enterprise 官方密钥分组。 ## 先确认令牌类型和分组 GPT Image 2 的线路由**创建令牌时选择的扣费类型和分组**决定，不是只看请求体里的 `model`。同一个 `gpt-image-2` 模型名，在默认分组、`Sora2Official` 分组和 `GPTImage2 Enterprise` 分组下不是同一条线路。 创建默认分组令牌时使用按次扣费。`gpt-image-2` 和 `gpt-image-2-vip` 都是 **\$0.03/次**；需要尺寸和质量参数时使用 `gpt-image-2-vip`。 创建 `Sora2Official` 分组令牌时使用按量扣费。请求体模型名仍然是 `gpt-image-2`，按官方输入 / 输出 tokens 计费。 创建 `GPTImage2 Enterprise` 分组令牌时使用按量扣费。走官方密钥线路，按官方输入 / 输出 tokens 价格 +20% 计费。 先看令牌类型，再看模型名。默认分组是按次扣费令牌；`Sora2Official` 和 `GPTImage2 Enterprise` 是按量扣费令牌。请求体里把 `model` 写成 `gpt-image-2` 并不会把按次令牌变成按量令牌。 2026 年 7 月 9 日更新：默认分组 `gpt-image-2-vip` 已恢复支持 `size` 和 `quality` 参数。最新验证中，`1024x1024`、`2048x2048`、`3840x2160` 均可按请求尺寸返回；`quality` 支持 `low`、`medium`、`high` 三档。 不要把 `Sora2Official` 或 `GPTImage2 Enterprise` 写进请求体的 `model` 字段。它们是创建令牌时选择的分组；请求体里仍然写 `model="gpt-image-2"`。 可以先在 [yingtu.ai](https://yingtu.ai) 在线测试效果，再迁移到 API。 ## 线路对照 | 令牌分组 | 令牌类型 | 模型名 | 线路 | 计费 | `size` | `quality` | 可用接口 | | ---------------------- | ------ | ----------------- | --------------------- | ------------------------ | -------------------- | ---------------------------- | ------------------- | | 默认分组 | 按次扣费令牌 | `gpt-image-2` | 默认标准线路 | **\$0.03/次** | 不支持 | 不支持 | Images 生成、Images 编辑 | | 默认分组 | 按次扣费令牌 | `gpt-image-2-vip` | VIP 线路 | **\$0.03/次** | 支持 1K / 2K / 4K 常用尺寸 | 支持 `low` / `medium` / `high` | Images 生成、Images 编辑 | | `Sora2Official` | 按量扣费令牌 | `gpt-image-2` | AZ + 官方密钥 混合官方 API 转发 | 按官方输入 / 输出 tokens 计费 | 支持 | 支持 | Images 生成、Images 编辑 | | `GPTImage2 Enterprise` | 按量扣费令牌 | `gpt-image-2` | 官方密钥 API | 官方输入 / 输出 tokens 计费 +20% | 支持 | 支持 | Images 生成、Images 编辑 | ## 怎么选 | 你的需求 | 选择 | | ----------------------------------- | ------------------------------------------------------------------------------ | | 想按 **\$0.03/次** 扣费 | 创建默认分组的按次扣费令牌；需要尺寸/质量时用 `model="gpt-image-2-vip"` | | 想按官方输入 / 输出 tokens 按量扣费 | 创建 `Sora2Official` 或 `GPTImage2 Enterprise` 的按量扣费令牌；请求体写 `model="gpt-image-2"` | | 已接入默认分组 `gpt-image-2-vip` | 这是按次扣费令牌，可以继续传 `size` / `quality` | | 已有官方 OpenAI GPT Image 2 代码，希望参数完全一致 | 创建 `Sora2Official` 或 `GPTImage2 Enterprise` 按量扣费令牌，然后保留 `model="gpt-image-2"` | | 不确定为什么扣费方式不对 | 先检查控制台里这个 Key 的令牌分组；不要只看请求体里的 `model` | ## 基础配置 所有线路都使用同一个 OpenAI 兼容网关地址： ```bash theme={null} export LAOZHANG_API_KEY="sk-你的令牌" export BASE_URL="https://api.laozhang.ai/v1" ``` 不要把 base URL 写成模型路径，也不要用请求体里的 `model` 改变扣费方式。实际线路由创建令牌时选择的分组和请求里的 `model` 字段共同决定。 ## 参数支持 ### 默认分组 gpt-image-2 默认分组的 `gpt-image-2` 是默认标准线路，适合不需要尺寸控制的快速接入。 * 不支持 `size` * 不支持 `quality` * 价格：**\$0.03/次** ### 默认分组 gpt-image-2-vip 默认分组的 `gpt-image-2-vip` 已恢复支持尺寸和质量参数，适合需要按次扣费、同时需要 1K / 2K / 4K 尺寸控制的图像生成请求。 * 支持 `size`，常用值包括 `1024x1024`、`2048x2048`、`3840x2160` * 支持 `quality`，常用值包括 `low`、`medium`、`high` * 默认返回 `data[0].b64_json` * 如需完整官方密钥线路和更严格的官方参数兼容，请使用官转分组 * 价格：**\$0.03/次** `quality` 会显著影响生成耗时和输出 token 量。低成本或批量预览可先用 `low` / `medium`，最终图再使用 `high`。 ### Sora2Official 分组 gpt-image-2 `Sora2Official` 分组的 `gpt-image-2` 是 AZ + 官方密钥 混合官方 API 转发 线路，按官方输入 / 输出 tokens 计费，价格与官方 OpenAI GPT Image 2 API 一致。 ### GPTImage2 Enterprise 分组 gpt-image-2 `GPTImage2 Enterprise` 分组的 `gpt-image-2` 是官方密钥 API 线路，适合对稳定性和官方线路一致性要求更高的生产调用。计费为官方输入 / 输出 tokens 价格 +20%，包含上游费用与运营成本，非利润加价。 ### 官方兼容分组共同参数 使用方式： 1. 在控制台创建**按量扣费令牌**。 2. 普通官方 API 转发选择 `Sora2Official`；优先稳定性和官方密钥 线路时选择 `GPTImage2 Enterprise`。 3. 请求体继续使用 `model="gpt-image-2"`。 4. 保留官方请求体，只替换 base URL 和 API Key。 支持官方参数，包括 `size`、`quality` 以及官方 API 支持的其他参数。 常用 `size`： * `1024x1024` * `1536x1024` * `1024x1536` * `2048x2048` * `2048x1152` * `3840x2160` * `2160x3840` * `auto` `quality` 可用值： * `low` * `medium` * `high` * `auto` ## 接口支持 本页只文档化 Images API 接入方式：文生图使用 `/v1/images/generations`，图改图使用 `/v1/images/edits`。SDK 对应 `images.generate` 和 `images.edit`。 | 需求 | 接口 | 说明 | | --- | ------------------------ | ------------------------------------------ | | 文生图 | `/v1/images/generations` | 默认返回 `data[0].b64_json`，也可返回 `data[0].url` | | 图改图 | `/v1/images/edits` | multipart 上传本地图片 | `Sora2Official` 和 `GPTImage2 Enterprise` 官方兼容方案必须使用官方一致的 Images API： | 需求 | 接口 | 说明 | | --- | ------------------------ | ----------------- | | 文生图 | `/v1/images/generations` | 和官方 Images 生成接口一致 | | 图改图 | `/v1/images/edits` | 和官方 Images 编辑接口一致 | 无论使用默认分组线路、`gpt-image-2-vip`，还是 `Sora2Official` / `GPTImage2 Enterprise` 官方兼容线路，文档接入方式都只保留 Images 生成和 Images 编辑两类接口。 ## 文生图示例 ### 默认分组 gpt-image-2（按次扣费令牌） 不要传 `size` 或 `quality`。 ```bash theme={null} curl "$BASE_URL/images/generations" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $LAOZHANG_API_KEY" \ -d '{ "model": "gpt-image-2", "prompt": "生成一张白色陶瓷马克杯放在灰色桌面上的产品图，柔和自然光，简洁背景" }' ``` ### 默认分组 gpt-image-2-vip（按次扣费令牌） `gpt-image-2-vip` 已恢复支持 `size` 和 `quality`。需要按次扣费并控制尺寸时，可以直接在请求体中传入这些参数。 ```bash theme={null} curl "$BASE_URL/images/generations" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $LAOZHANG_API_KEY" \ -d '{ "model": "gpt-image-2-vip", "prompt": "生成一张白色陶瓷马克杯放在灰色桌面上的产品图，柔和自然光，简洁背景", "size": "2048x2048", "quality": "high" }' ``` ### Sora2Official / GPTImage2 Enterprise 分组 gpt-image-2（按量扣费令牌） 使用官方一致的 Images 生成接口，可以传 `size` 和 `quality`。 ```bash theme={null} curl "$BASE_URL/images/generations" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $LAOZHANG_API_KEY" \ -d '{ "model": "gpt-image-2", "prompt": "生成一张白色陶瓷马克杯放在灰色桌面上的产品图，柔和自然光，简洁背景", "size": "1536x1024", "quality": "high" }' ``` ## 图改图示例 ### 默认分组 Images Edits ```bash theme={null} curl "$BASE_URL/images/edits" \ -H "Authorization: Bearer $LAOZHANG_API_KEY" \ -F "model=gpt-image-2" \ -F "prompt=使用提供的图片作为源图。保留主体、构图和文字，只把杯身贴纸改成红色，并给杯口加一条很细的金色边。" \ -F "image=@source.png" ``` ### 默认分组 gpt-image-2-vip Images Edits ```bash theme={null} curl "$BASE_URL/images/edits" \ -H "Authorization: Bearer $LAOZHANG_API_KEY" \ -F "model=gpt-image-2-vip" \ -F "prompt=使用提供的图片作为源图。保留主体、构图和文字，只把贴纸改成蓝色。" \ -F "image=@source.png" ``` ### Sora2Official / GPTImage2 Enterprise 分组 Images Edits 官方兼容分组的图改图必须使用 `/v1/images/edits`，参数按官方 API 写法。 ```bash theme={null} curl "$BASE_URL/images/edits" \ -H "Authorization: Bearer $LAOZHANG_API_KEY" \ -F "model=gpt-image-2" \ -F "prompt=使用提供的图片作为源图。保留主体、构图和文字，只把贴纸改成绿色。" \ -F "image=@source.png" \ -F "size=1024x1024" \ -F "quality=high" ``` ## 返回结果解析 ### 保存 Images API 的 b64\_json ```python theme={null} import base64 value = response["data"][0]["b64_json"] if value.startswith("data:"): value = value.split(",", 1)[1] value += "=" * ((4 - len(value) % 4) % 4) with open("output.png", "wb") as f: f.write(base64.b64decode(value)) ``` ### 读取 Images API 的 URL ```python theme={null} image_url = response["data"][0]["url"] ``` ## 常见问题 因为线路由令牌分组决定。默认分组的 `gpt-image-2` 是按次扣费标准线路；`Sora2Official` 分组的 `gpt-image-2` 是按量扣费的 AZ + 官方密钥混合官方 API 转发；`GPTImage2 Enterprise` 分组的 `gpt-image-2` 是按量扣费的官方密钥 API。 看控制台创建令牌时选择的分组。默认分组是按次扣费令牌，`gpt-image-2` / `gpt-image-2-vip` 按 **\$0.03/次** 扣费；`Sora2Official` 和 `GPTImage2 Enterprise` 是按量扣费令牌，模型名仍写 `gpt-image-2`，但按官方输入 / 输出 tokens 计费。 默认分组 `gpt-image-2` 不作为尺寸控制线路承诺。需要默认分组按次扣费并控制尺寸时，请使用已恢复参数支持的 `gpt-image-2-vip`；需要完整官方密钥线路时，请使用 `Sora2Official` 或 `GPTImage2 Enterprise` 分组的 `gpt-image-2`。 可以。`gpt-image-2-vip` 当前支持 `low`、`medium`、`high` 三档 `quality`。质量越高，通常等待时间和输出 token 量越高。 可以。当前可使用 `3840x2160` 等 4K 横屏尺寸；如需竖屏 4K，可按业务场景测试 `2160x3840`。 这页只保留 Images API 接入方式：文生图使用 `/v1/images/generations`，图改图使用 `/v1/images/edits`。 先创建 `Sora2Official` 或 `GPTImage2 Enterprise` 分组的按量扣费令牌。迁移时保留官方请求体和 `model="gpt-image-2"`，把 base URL 改为 `https://api.laozhang.ai/v1`，把 API Key 改成 LaoZhang API 令牌。需要官方密钥线路时，优先选择 `GPTImage2 Enterprise`。 常见原因是返回值带了 `data:image/png;base64,` 前缀，或者末尾缺少 padding。先去掉前缀，再补齐 `=` 后再做 base64 解码。