GPT Image 2.5 AZ · 官 Key / Token 计费

知梦新增两款官 Key 生图模型：gpt-image-2.5-flare-az 与 gpt-image-2.5-sunburst-az。通过官方 API Key 渠道调用，使用 Images 接口的对应模型参数。文生图提交 JSON；图生图 / 改图必须使用 multipart/form-data，以 image[] 文件字段上传参考图，多张重复该字段。

与按张计费的模型分别列出：AZ 根据实际输入、输出 Token 结算，不能用固定“每张多少钱”估算所有请求。模型名中的 -az 为知梦接入 ID，不需要再加 -2k / -4k。

Flare AZ 在线调试 → · Sunburst AZ 在线调试 →

模型与接口

项目	内容
Flare AZ	`gpt-image-2.5-flare-az`
Sunburst AZ	`gpt-image-2.5-sunburst-az`
REST Base URL	`https://api.zmoapi.cn`
OpenAI SDK Base URL	`https://api.zmoapi.cn/v1`
文生图	`POST /v1/images/generations`，`application/json`
图片编辑 / 参考图 / 蒙版	`POST /v1/images/edits`，`multipart/form-data`
鉴权	`Authorization: Bearer YOUR_API_KEY`
计费	输入 Token + 输出 Token；按请求的 `quality` 选择费率

客户仍使用自己的知梦 API Key；“官 Key”指供给渠道，不表示需要客户另行提供 OpenAI 原站密钥。Flare 与 Sunburst 使用同一请求格式，替换 model 即可切换。-az 接入 ID 不能直接当作 OpenAI 原站模型名。

价格与计算方式

两款模型采用下表相同的基础费率，单位为人民币 CNY / 每百万 Token，按实际 Token 用量结算，不按张固定计价。

请求中的 `quality`	计费档位	输入 / 百万 Token	输出 / 百万 Token	相对标准档
省略、`auto`、`low`、`medium`、`high`	`standard`	¥15	¥90	1 倍
`xhigh`	`xhigh`	¥18.75	¥112.5	1.25 倍
`max`	`max`	¥22.5	¥135	1.5 倍

先匹配请求里的 quality == "max"，再匹配 "xhigh"，其余进入标准计费档。auto 属于标准档，不根据最终返回图片的质量字段重新选择档位。计费兜底不表示任意未知 quality 都是合法参数，官方支持值仍只有表中六项。

text

基础费用（人民币 CNY）
  = 输入计费 Token 数 / 1,000,000 × 输入单价
  + 输出计费 Token 数 / 1,000,000 × 输出单价

这里的输入、输出是计费 Token 用量，不能只数提示词文字；参考图片也会产生输入 Token。当前规则没有另外列出缓存、图片输入或图片输出的独立折扣，相关用量按输入 / 输出两项结算。不要在此基础上重复加一次“图片 Token 费”，也不要把多个输出已经产生的总 Token 费用再乘一次 n。

例如一次请求计费输入 1,000 Token、输出 2,000 Token，未计账户适用倍率：

档位	计算	基础费用
standard	`1000 / 1000000 × 15 + 2000 / 1000000 × 90`	¥0.195
xhigh	`1000 / 1000000 × 18.75 + 2000 / 1000000 × 112.5`	¥0.24375
max	`1000 / 1000000 × 22.5 + 2000 / 1000000 × 135`	¥0.2925

这只是给定 Token 用量的计算示例，不是固定单张价格。尺寸、内容、参考素材、质量和数量会影响实际用量。上述单价直接以人民币计价，不进行美元换算；账户适用倍率按平台配置执行，最终以消费记录为准。

官方参数

生成用 JSON；AZ 编辑只采用上游明确要求的 multipart 文件上传。不要把 OpenAI 原站的 JSON images[].image_url / Data URL / file_id 格式直接套用到 AZ 渠道，也不要发送到 /v1/chat/completions。以下为模型参数，multipart 的标量按表单字段传递，不需要附带计费表达式或 tier 字段。

字段	类型	说明
`model`	string	使用两个精确的 `-az` 模型 ID 之一。
`prompt`	string	必填，生成 / 编辑描述，最长 32000 字符。
`size`	string	`auto` 或 `WIDTHxHEIGHT`；控制实际原生输出尺寸，不通过模型后缀选尺寸。
`quality`	string	`auto` / `low` / `medium` / `high` / `xhigh` / `max`；同时决定上述计费档位。
`n`	integer	1–10 张，默认 1；多张结果遍历返回的 `data`。
`output_format`	string	`png` / `jpeg` / `webp`；默认 PNG。
`output_compression`	integer	0–100，仅用于 JPEG / WebP，默认 100；PNG 不传。
`background`	string	`opaque` / `transparent`；官方通用参数还定义 `auto` 默认行为。示例与调试默认显式使用 `opaque`；透明背景搭配 PNG / WebP。
`moderation`	string	`auto` / `low`，默认 auto；控制官方审核策略，不保证绕过内容限制。
`stream`	boolean	默认 false；true 使用官方图片 SSE 事件，不能按 Chat Completions 的 delta 解析。
`partial_images`	integer	stream 为 true 时使用，0–3；0 表示只请求最终完成图。中间图数量不保证全部出现。
`safety_identifier`	string	可选，最长 128 字符的稳定用户安全标识；建议使用业务用户 ID 的哈希，不发送明文隐私信息。
`user`	string	兼容的旧用户标识，官方已弃用；优先用 `safety_identifier`。
`image[]`	file	编辑必填的二进制参考图；多图重复同名字段，最多 16 张。支持 PNG / JPEG / WebP，每张小于 50 MB；不填 URL 文本或裸 Base64。
`mask`	file	可选编辑蒙版文件，透明区域表示编辑区域；需与第一张参考图尺寸一致，多图时作用于第一张。

参考图格式、体积和蒙版要求沿用官方 Images 编辑说明。AZ 渠道不要传 response_format（该字段仅按张计费的 1K 模型 gpt-image-2 / gpt-image-2.5-flare / gpt-image-2.5-sunburst 支持），也不要填旧模型的 style 或没有为本模型明确开放的 input_fidelity；“完整参数”不表示所有历史模型的字段都适用。

原生尺寸

宽高均需为 16 的倍数，比例在 1:3 至 3:1，单边不超过 3840 像素，总像素数在 655360–8294400；高于 2560x1440 为官方实验性高分辨率。常用值包括：

画幅	`size` 示例
正方形	`1024x1024`、`2048x2048`
横屏	`1536x864`、`2048x1152`
竖屏	`864x1536`、`1152x2048`
4K 横屏（实验性）	`3840x2160`
4K 竖屏（实验性）	`2160x3840`

这是官方原生尺寸请求，与 Ext 超分模型的超分输出分开介绍；4K 实验性请求仍受官方当前能力限制。

文生图示例

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.5-flare-az",
    "prompt": "商业产品摄影，一只白色陶瓷茶杯，柔和自然光，清晰材质细节",
    "size": "1536x864",
    "quality": "high",
    "background": "opaque",
    "output_format": "png",
    "n": 1,
    "stream": false
  }'

high 在标准计费档；不代表按张收费。要使用 Sunburst 和 max 档，替换为：

json

{
  "model": "gpt-image-2.5-sunburst-az",
  "prompt": "清晨山城全景，真实摄影，丰富纹理与层次",
  "size": "2048x1152",
  "quality": "max",
  "background": "opaque",
  "output_format": "webp",
  "output_compression": 90,
  "n": 1,
  "stream": false
}

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-sunburst-az",
    prompt="清晨山城全景，真实摄影，丰富纹理与层次",
    size="2048x1152",
    quality="xhigh",
    background="opaque",
    output_format="png",
    n=1,
)
for index, image in enumerate(result.data):
    with open(f"image-{index}.png", "wb") as file:
        file.write(base64.b64decode(image.b64_json))
print(result.usage)

参考图编辑

多张参考图

图生图 / 改图必须向 /v1/images/edits 提交 multipart，每张参考图都是 image[] 文件字段。下面的两张图片按顺序上传，模型通过提示词理解各图作用：

bash

curl 'https://api.zmoapi.cn/v1/images/edits' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'model=gpt-image-2.5-sunburst-az' \
  -F 'prompt=保留第一张图中的人物外观，参考第二张图的构图和姿势' \
  -F 'image[]=@./person.jpg' \
  -F 'image[]=@./pose.jpg' \
  -F 'size=1152x1536' \
  -F 'quality=medium' \
  -F 'background=opaque' \
  -F 'output_format=png' \
  -F 'n=1'

URL / Base64 素材如何使用

AZ 接口不直接接收 JSON URL / Base64 / 文件 ID 参考。业务端需要先下载 URL 图片，或将 Base64 解码为图片文件，再通过 image[] 上传。下载与上传是两步，知梦 API Key 只发给知梦 API，不发给图床。

bash

# 先将真实图片直链下载到本地；下载失败时停止，不提交生成请求。
curl --fail --location 'https://example.com/reference.jpg' --output ./az-reference.jpg &&
curl 'https://api.zmoapi.cn/v1/images/edits' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'model=gpt-image-2.5-flare-az' \
  -F 'prompt=保持产品外观，将背景改为纯白摄影棚' \
  -F 'image[]=@./az-reference.jpg' \
  -F 'size=1536x1024' \
  -F 'quality=xhigh' \
  -F 'background=opaque' \
  -F 'output_format=png'

多张 URL 先分别下载，再重复添加 -F 'image[]=@./图片文件'。仅把 URL 字符串放入 image[] 也不等于上传文件。不要手动把表单的 Content-Type 设为 JSON。

调试台保留 URL 输入便利：发送前由浏览器下载图片，再转成 multipart 文件。图床必须允许跨域读取（CORS）；出现下载失败、超时或格式错误时会停止，不提交生成请求。图床不允许 CORS 时，请将图片保存到本地后选择上传。URL 参考图在前，本地图片在后；蒙版作用于第一张图。

本地参考图与蒙版

bash

curl 'https://api.zmoapi.cn/v1/images/edits' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'model=gpt-image-2.5-sunburst-az' \
  -F 'prompt=保留杯子主体，在蒙版透明区域添加绿植' \
  -F 'image[]=@./reference.png' \
  -F 'mask=@./mask.png' \
  -F 'size=1536x1024' \
  -F 'quality=max' \
  -F 'background=opaque' \
  -F 'output_format=png' \
  -F 'n=1' \
  -F 'stream=false'

让 HTTP 客户端生成 multipart 边界，不手工填写 Content-Type: application/json。参考图片和蒙版均可能影响输入用量。

官方 SSE 与返回用量

bash

curl -N 'https://api.zmoapi.cn/v1/images/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data-raw '{
    "model": "gpt-image-2.5-flare-az",
    "prompt": "雨后的城市街道，电影感摄影",
    "size": "1536x864",
    "quality": "medium",
    "stream": true,
    "partial_images": 2
  }'

图片生成流的事件包括 image_generation.partial_image 与 image_generation.completed；编辑对应 image_edit.partial_image 与 image_edit.completed。只有 completed 代表最终完成，中间预览不应作为最终交付；错误或连接中断不能自动重发创建请求。

非流式结果读取 data[].b64_json；流式完成事件读取 b64_json。将 Base64 解码为所选格式。用量从普通响应或完成事件中的 usage 读取，关注 input_tokens、output_tokens 和明细；字段缺失不能擅自按 0 费用处理，账单以平台实际记录为准。不要用输出图片的文件字节数代替 Token 数。

在线调试

Flare AZ 调试台 · Sunburst AZ 调试台

可选择六档 quality、官方尺寸预设或自定义尺寸、本地参考图和蒙版；URL 图片先下载再转为文件上传，受图床 CORS 限制。编辑请求统一为 multipart，预览 JSON 页签只是表单字段展示，接入时请使用 cURL / JavaScript / Python 中的文件上传写法。在高级参数的 JSON 框补充 n、output_compression、moderation、stream、partial_images、safety_identifier、user；基本字段使用对应专用控件，避免互相覆盖。切换 quality 会同步显示当前 CNY / 百万 Token 费率。

调试台的 SSE 在流结束后解析最终完成图，并保留原始事件文本，不实时播放中间图片；需要边生成边展示预览时按官方 SSE 事件自行开发。不直接向 AZ 编辑接口发送 JSON images、image_url 或 file_id。

GPT Image 2.5 AZ · 官 Key / Token 计费 ​

模型与接口 ​

价格与计算方式 ​

官方参数 ​

原生尺寸 ​

文生图示例 ​

OpenAI Python SDK ​

参考图编辑 ​

多张参考图 ​

URL / Base64 素材如何使用 ​

本地参考图与蒙版 ​

官方 SSE 与返回用量 ​

在线调试 ​

参考 ​

GPT Image 2.5 AZ · 官 Key / Token 计费

模型与接口

价格与计算方式

官方参数

原生尺寸

文生图示例

OpenAI Python SDK

参考图编辑

多张参考图

URL / Base64 素材如何使用

本地参考图与蒙版

官方 SSE 与返回用量

在线调试

参考