GPT Image 2.5
新增模型与接入说明
gpt-image-2.5-flare、gpt-image-2.5-sunburst,请求时填写完整模型名。
POST /v1/images/generations 接口,沿用 UniKeyX 的 Base URL 和 API Key。
GPT-Image-2.5。已有 Key 需确认所属分组支持这两款模型。
公开资料尚未列出 Flare 与 Sunburst 的完整参数差异,不直接套用 GPT Image 2 的限制。已知取值与待确认项见参数区别 FAQ。
模型接入、可用分组与当前价格,请以 UniKeyX 模型广场 为准。
Generation
图片生成示例
GPT Image 2.5 先用最小请求验证接入,不额外指定尚未确认的尺寸或质量参数。取值说明见参数区别 FAQ。
curl https://www.unikeyx.com/v1/images/generations \
-H "Authorization: Bearer YOUR_UNIKEYX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.5-flare",
"prompt": "一张咖啡豆礼盒的电商主图,白色背景,柔和棚拍光,标题为:秋日咖啡季"
}'
curl https://www.unikeyx.com/v1/images/generations \
-H "Authorization: Bearer YOUR_UNIKEYX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.5-sunburst",
"prompt": "一张咖啡豆礼盒的电商主图,白色背景,柔和棚拍光,标题为:秋日咖啡季"
}'
切换模型时,只需将 model 改为另一款完整模型名。以下保留 MAI 和 GPT Image 2 示例。
curl https://www.unikeyx.com/v1/images/generations \
-H "Authorization: Bearer YOUR_UNIKEYX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MAI-Image-2",
"prompt": "一张高端咖啡豆礼盒的中文电商主图,白色背景,柔和棚拍光,真实产品摄影风格",
"width": 1024,
"height": 1024
}'
import base64
from openai import OpenAI
client = OpenAI(
api_key="YOUR_UNIKEYX_API_KEY",
base_url="https://www.unikeyx.com/v1",
)
result = client.images.generate(
model="gpt-image-2",
prompt="A clean editorial illustration of a small AI API gateway, with modern product UI details.",
size="1024x1024",
quality="high",
n=1,
)
with open("gpt-image-2-output.png", "wb") as file:
file.write(base64.b64decode(result.data[0].b64_json))
Editing
参考图改图示例
下方改图示例使用 MAI 和 gpt-image-2。GPT Image 2.5 的编辑支持及参数边界尚未确认,请勿直接套用。
curl -sS https://www.unikeyx.com/v1/images/edits \
-H "Authorization: Bearer YOUR_UNIKEYX_API_KEY" \
-F "model=MAI-Image-2.5" \
-F "prompt=保留商品主体,替换为夏季户外露营场景,加入中文标题:清爽上新,真实商业摄影风格" \
-F "image=@./product-reference.png" \
| jq -r '.data[0].b64_json' \
| base64 --decode > mai-image-2-5-edit.png
import base64
from openai import OpenAI
client = OpenAI(
api_key="YOUR_UNIKEYX_API_KEY",
base_url="https://www.unikeyx.com/v1",
)
with open("product-reference.png", "rb") as image_file:
result = client.images.edit(
model="gpt-image-2",
image=image_file,
prompt="Keep the product shape and logo readable. Rebuild the scene as a premium e-commerce hero image.",
size="1024x1024",
quality="high",
)
with open("gpt-image-2-edit.png", "wb") as file:
file.write(base64.b64decode(result.data[0].b64_json))
Parameters
常用参数
gpt-image-2.5-flare、gpt-image-2.5-sunburst、gpt-image-2;MAI 示例使用 MAI-Image-2、MAI-Image-2.5。
768,总像素不超过 1,048,576。
gpt-image-2 使用 宽x高 字符串:16 像素步进,单边小于等于 3840,总像素 655,360~8,294,400,比例限制在 1:3~3:1。GPT Image 2.5 的尺寸范围尚未确认,先省略此参数。
gpt-image-2 可用 auto、low、medium、high。GPT Image 2.5 暂不指定;MAI 模型不建议传。
multipart/form-data 上传 PNG 或 JPEG 等有效图片文件。
FAQ
图片生成 FAQ
gpt-image-2 与两款 GPT Image 2.5 的参数有什么区别?
对比 gpt-image-2、gpt-image-2.5-flare、gpt-image-2.5-sunburst。GPT Image 2 取值沿用本页现有说明;两款 2.5 尚未取得完整参数说明,不能认定与旧模型相同。“待确认”不代表不支持。
model 和文字 prompt。切换模型必须更改完整模型名。
宽x高,宽高为 16 的倍数,单边 ≤ 3840,总像素 655,360~8,294,400,宽高比 1:3~3:1。Flare、Sunburst:范围待确认,先省略 size。
auto / low / medium / high。Flare、Sunburst:可用档位待确认,先省略 quality,不要直接套用旧模型档位。
/images/edits 上传参考图,本页示例使用 PNG 或 JPEG。Flare、Sunburst:编辑接口、文件大小及参考图数量待确认。
n=1;本页未核实三者的批量上限,以及 background、output_format、output_compression、input_fidelity 的完整取值,不作相同或不同的断言。
b64_json 或 url 字段读取。
两款 2.5 先用仅含 model、prompt 的示例检查接入;尺寸、质量、透明背景等高级参数,待确认所选分组支持后再加。
Flare 和 Sunburst 有什么区别?
两款模型均已支持图片生成接入,公开价格列表均有缓存读取计费项。目前没有可核对的画质、速度或尺寸差异说明;不能仅凭名称认定哪一款更快或更精细。
新模型不可用,或提示没有可用渠道
检查模型名是否完整填写为 gpt-image-2.5-flare 或 gpt-image-2.5-sunburst。令牌分组建议选 GPT-Image-2.5,不要误用旧的 GPT-Image2 分组;同时确认 Key 有效且额度充足。
GPT Image 2.5 报尺寸或参数错误
先使用本页仅包含 model、prompt 的生图示例。不要直接复制 GPT Image 2 的尺寸边界、编辑参数或旧版 DALL-E 的 response_format。
图片返回 base64 而不是 URL
不同上游和通道配置可能返回不同图片字段。客户端建议同时兼容 url 和 b64_json。
gpt-image-2 的 size 应该怎么填?
使用 宽x高 字符串,例如 1024x1024、1024x1536、
1536x1024、2048x2048、3840x2160、
2160x3840、1024x3072。
宽高都应能被 16 整除;单边小于等于 3840;总像素需在
655,360~8,294,400 之间;宽高比限制在 1:3~3:1。
gpt-image-2 的 quality 应该怎么填?
常用 auto、low、medium、high。
不确定时用 auto;最终出图可用 high。
MAI-Image-2 的尺寸应该怎么填?
MAI-Image-2 使用 width 和 height 整数字段。
宽高各不低于 768,总像素不超过 1,048,576。
常用方图 1024x1024,横图 1024x768,
竖图 768x1024。不要把 GPT 的 size 字段直接复制到 MAI 示例里。
MAI 图片模型要传 quality 吗?
不建议传 quality。想提升效果,优先优化提示词和参考图质量。
400: Unknown parameter response_format
使用 gpt-image-2 做图片编辑时,不要传 response_format。
删除旧版 DALL-E 示例中的 response_format 后重试。
400: Invalid image file or mode
先只保留一张图调用,定位是哪张文件触发错误。建议重新导出为普通 RGB PNG 或 JPEG, 并确认文件能正常打开。
生图报 The requested operation is unsupported
本页生图示例使用 /images/generations,已确认的图片编辑示例使用
/images/edits。检查接口路径、模型名和令牌分组,不要直接套用文本对话的请求格式。