外观
GPT Image Ext 超分模型
gpt-image-2-ext 与 gpt-image-2.5-ext 是知梦提供的超分模型，支持 2K / 4K 输出。这里的 2K / 4K 为超分输出，非原生 2K / 4K 生成。请求按照 OpenAI Images API 官方协议组织，不需要另接一套超分接口。
模型与选择
| 模型 ID | 输出能力 | 单价 | 说明 |
|---|---|---|---|
gpt-image-2-ext | 2K / 4K 超分 | ¥0.035 / 张 | GPT Image 2 超分模型 |
gpt-image-2.5-ext | 2K / 4K 超分 | ¥0.035 / 张 | 默认使用 Sunburst |
保持以上模型名原样，通过 size 指定目标输出尺寸；不要自行改为 gpt-image-2-ext-2k、gpt-image-2-ext-4k 等未列出的模型名。gpt-image-2.5-ext 无需额外传 sunburst 或分支选择字段。
Ext 与现有 gpt-image-2-2k、gpt-image-2-4k、Flare / Sunburst 档位分别列出，不能仅凭文件尺寸将超分输出介绍为原生高分辨率生成。两款 Ext 的 2K / 4K 超分输出均为人民币 ¥0.035 / 张，按生成张数计费；实际消费以平台记录为准。
GPT Image 2 Ext 在线调试 → · GPT Image 2.5 Ext 在线调试 →
接口与鉴权
| 项目 | 地址 / 写法 |
|---|---|
| REST Base URL | https://api.zmoapi.cn |
| OpenAI SDK Base URL | https://api.zmoapi.cn/v1 |
| 文生图 | POST /v1/images/generations，JSON |
| 图片编辑 / 参考图 | POST /v1/images/edits，按官方 Images 编辑格式 |
| 鉴权 | Authorization: Bearer YOUR_API_KEY |
协议、参考图和响应处理沿用 OpenAI Images 接入文档。-ext 是本站模型 ID，不能作为 OpenAI 官方原站的模型名使用。
参数与输出尺寸
| 参数 | 类型 | 说明 |
|---|---|---|
model | string | 必填，使用上表两个精确模型 ID 之一。 |
prompt | string | 必填，生成或编辑要求。 |
size | string | 指定目标输出像素尺寸，使用 WIDTHxHEIGHT，见下方示例；无需额外发送 resolution。 |
quality | string | GPT Image 2：auto / low / medium / high；2.5 的官方参数体系另支持 xhigh / max。超分输出与质量档位是不同概念。 |
n | integer | 生成数量，示例使用 1，不是超分倍数。 |
output_format | string | png / jpeg / webp，示例使用 PNG。 |
background | string | 按对应 GPT Image 模型的官方背景参数使用；透明背景搭配 PNG / WebP。 |
images / image | 参考素材 | 仅编辑接口使用，分别按官方 JSON URL 或 multipart 文件格式提交，见下方示例。 |
| 其他官方可选字段 | — | 继续按 完整 Images 参数说明 组织，不添加自定义 upscale、scale 或模型分支字段。 |
常用横竖屏预设如下，调试台提供这四个选项：
| 输出 | 比例 | size |
|---|---|---|
| 2K 超分横屏 | 16:9 | 2048x1152 |
| 2K 超分竖屏 | 9:16 | 1152x2048 |
| 4K 超分横屏 | 16:9 | 3840x2160 |
| 4K 超分竖屏 | 9:16 | 2160x3840 |
官方 size 使用像素尺寸字符串，宽高需为 16 的倍数，比例在 1:3 至 3:1；其他尺寸还受模型当前像素数和边长限制。上表仅列常用输出示例。不要把 "2k"、"4k" 当作 size 值，也不要通过改变 quality 代替 size。
文生图：2K 超分
bash
curl 'https://api.zmoapi.cn/v1/images/generations' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
--data-raw '{
"model": "gpt-image-2-ext",
"prompt": "极简产品摄影，一只新鲜柠檬放在白色背景上，柔和棚拍光",
"size": "2048x1152",
"quality": "medium",
"output_format": "png",
"n": 1
}'文生图：2.5 Ext 的 4K 超分
同一接口，默认使用 Sunburst；只需填写对应模型 ID 和目标 size：
json
{
"model": "gpt-image-2.5-ext",
"prompt": "清晨山城全景，电影感光影，画面层次清晰",
"size": "3840x2160",
"quality": "medium",
"output_format": "png",
"n": 1
}OpenAI Python SDK
python
import base64
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.zmoapi.cn/v1",
)
result = client.images.generate(
model="gpt-image-2.5-ext",
prompt="清晨山城全景，电影感光影，画面层次清晰",
size="3840x2160",
quality="medium",
output_format="png",
n=1,
)
with open("image-ext.png", "wb") as file:
file.write(base64.b64decode(result.data[0].b64_json))参考图：URL 与本地文件
URL 参考图使用 JSON 编辑接口，图片链接须可由服务端公开读取：
bash
curl 'https://api.zmoapi.cn/v1/images/edits' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
--data-raw '{
"model": "gpt-image-2.5-ext",
"prompt": "保持参考产品外观，将背景改为明亮的白色摄影棚",
"images": [{"image_url": "https://example.com/reference.png"}],
"size": "3840x2160",
"quality": "medium",
"output_format": "png"
}'将占位链接换成自己的有效图片直链。本地文件使用官方 multipart 写法，不手工设置 multipart 的 Content-Type 边界：
bash
curl 'https://api.zmoapi.cn/v1/images/edits' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-F 'model=gpt-image-2-ext' \
-F 'prompt=保持产品外观，改为柔和白色摄影棚背景' \
-F 'image[]=@./reference.png' \
-F 'size=2048x1152' \
-F 'quality=medium' \
-F 'output_format=png'调试台沿用 GPT Image 的本地图片和 URL 参考图逻辑；不把图片编辑请求发到文生图路径。
响应与保存
Ext 超分模型不支持 response_format，按官方 GPT Image 结果读取 data[].b64_json，Base64 解码后按 output_format 保存。需要 URL 返回请改用按张计费的 1K 模型（gpt-image-2 / gpt-image-2.5-flare / gpt-image-2.5-sunburst）。若生成多张，遍历 data 数组。
2K / 4K 描述的是输出尺寸和超分能力，不代表原生生成分辨率，也不保证超分会补回原图中不存在的真实细节。