Image API

图片生成与图片编辑

新增 gpt-image-2.5-flare 和 gpt-image-2.5-sunburst 图片生成模型。 本页提供 GPT Image 2.5 生图示例,以及 GPT Image 2、MAI 的生图和参考图编辑示例。

GPT 模型
gpt-image-2.5-flare / gpt-image-2.5-sunburst / gpt-image-2
Base URL
https://www.unikeyx.com/v1
生成接口
POST /images/generations
编辑接口
POST /images/edits

GPT Image 2.5

新增模型与接入说明

新增模型 gpt-image-2.5-flare、gpt-image-2.5-sunburst,请求时填写完整模型名。
图片生成 两款模型均已列出 POST /v1/images/generations 接口,沿用 UniKeyX 的 Base URL 和 API Key。
令牌分组 在 www.unikeyx.com 注册并创建令牌,分组建议选 GPT-Image-2.5。已有 Key 需确认所属分组支持这两款模型。
缓存读取计费 两款模型的公开价格列表均新增缓存读取计费项。是否命中缓存及实际费用,以响应中的用量信息和平台账单为准。

公开资料尚未列出 Flare 与 Sunburst 的完整参数差异,不直接套用 GPT Image 2 的限制。已知取值与待确认项见参数区别 FAQ。

模型接入、可用分组与当前价格,请以 UniKeyX 模型广场 为准。

1

Generation

图片生成示例

GPT Image 2.5 先用最小请求验证接入,不额外指定尚未确认的尺寸或质量参数。取值说明见参数区别 FAQ。

Flare 生图 · cURL
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": "一张咖啡豆礼盒的电商主图,白色背景,柔和棚拍光,标题为:秋日咖啡季"
  }'
Sunburst 生图 · cURL
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 示例。

MAI 生图
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
  }'
GPT Image 2 生图
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))
2

Editing

参考图改图示例

下方改图示例使用 MAI 和 gpt-image-2。GPT Image 2.5 的编辑支持及参数边界尚未确认,请勿直接套用。

MAI 改图
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
GPT Image 2 改图
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))
3

Parameters

常用参数

model 必填。GPT 生图可选 gpt-image-2.5-flare、gpt-image-2.5-sunburst、gpt-image-2;MAI 示例使用 MAI-Image-2、MAI-Image-2.5。
prompt 必填。说明主体、场景、风格、构图、光线、用途和要保留/替换的内容。
width / height MAI-Image-2 使用整数宽高:宽高各不低于 768,总像素不超过 1,048,576。
size gpt-image-2 使用 宽x高 字符串:16 像素步进,单边小于等于 3840,总像素 655,360~8,294,400,比例限制在 1:3~3:1。GPT Image 2.5 的尺寸范围尚未确认,先省略此参数。
quality gpt-image-2 可用 auto、low、medium、high。GPT Image 2.5 暂不指定;MAI 模型不建议传。
image 图片编辑必填。使用 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 三者均按本页生图示例填写完整 model 和文字 prompt。切换模型必须更改完整模型名。
size GPT Image 2:宽x高,宽高为 16 的倍数,单边 ≤ 3840,总像素 655,360~8,294,400,宽高比 1:3~3:1。Flare、Sunburst:范围待确认,先省略 size。
quality GPT Image 2:auto / low / medium / high。Flare、Sunburst:可用档位待确认,先省略 quality,不要直接套用旧模型档位。
image(编辑输入) GPT Image 2:通过 /images/edits 上传参考图,本页示例使用 PNG 或 JPEG。Flare、Sunburst:编辑接口、文件大小及参考图数量待确认。
n / 其他可选字段 GPT Image 2 示例使用 n=1;本页未核实三者的批量上限,以及 background、output_format、output_compression、input_fidelity 的完整取值,不作相同或不同的断言。
response_format GPT Image 2 编辑示例不传;两款 2.5 的最小生图示例同样不传,但不能据此认定接口一定不支持。返回图片时按实际 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。检查接口路径、模型名和令牌分组,不要直接套用文本对话的请求格式。