Appearance
gpt-image 图像生成
gpt-image 系列采用标准 OpenAI 图像生成规范。支持仅通过提示词的文生图,以及传入一张或多张参考图进行编辑的图生图。
接口基础信息
- 线路地址:
https://img.mzfe.de(优化线路)或https://img.zikl.dev(标准线路) - 鉴权方式:
Authorization: Bearer <API_KEY>
支持模型与分组说明
在调用接口时,model 字段支持以下模型:
| 模型名称 (Model ID) | 支持分组 | 说明 |
|---|---|---|
gpt-image-2 | GPT-image2 1K、福利分组1k图、备用1k生图、GPT-image2 2k 4k、GPT-image2-high | 基础 2.0 版本生图模型,性价比高,出图稳定 |
gpt-image-2.5 | GPT-image2 1K、福利分组1k图、备用1k生图 | 升级版 2.5 模型,细节表现与审美表现更强 |
gpt-image-2.5-flare | im2.5-1、2、4k、im2.5-原生、GPT-image2 1K、福利分组1k图、备用1k生图 | 2.5 Flare 特色版本,特定光影与艺术质感强化(注:在 1K 分组中最终统一请求 gpt-image-2.5) |
gpt-image-2.5-sunburst | im2.5-1、2、4k、im2.5-原生、GPT-image2 1K、福利分组1k图、备用1k生图 | 2.5 Sunburst 特色版本,高饱和与阳光通透感画面(注:在 1K 分组中最终统一请求 gpt-image-2.5) |
分组权限说明
具体能够调用的模型与输出尺寸取决于你在站点创建 API 密钥时所选择的分组:
- 1K 分组(如
GPT-image2 1K、福利分组1k图、备用1k生图等):支持 1K 规格生图,其中flare与sunburst在 1K 分组中最终统一请求gpt-image-2.5。 - 2K / 4K 分组(如
GPT-image2 2k 4k、im2.5-原生、im2.5-1、2、4k等):支持 1K / 2K / 4K 多档尺寸与原生 Flare / Sunburst 特色风格。 - 高画质分组(如
GPT-image2-high):支持在请求中传入quality: "high"高画质模式。
01 文生图
仅使用文字提示词生成图片,请求体为 JSON。
- 请求方式:
POST - 请求路径:
/v1/images/generations - Content-Type:
application/json
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
model | 是 | string | 填入你的分组支持的模型:gpt-image-2、gpt-image-2.5、gpt-image-2.5-flare 或 gpt-image-2.5-sunburst |
prompt | 是 | string | 文字提示词,中英文皆可 |
size | 否 | string | 尺寸。1K 分组最高支持 1K;4K 分组支持 1K / 2K / 4K;默认 auto |
quality | 否 | string | 画质。high 分组支持 high;其他分组默认 medium |
n | 是 | integer | 请固定传 1 |
response_format | 否 | string | 返回格式:url(默认)或 b64_json |
请求示例
bash
curl https://img.mzfe.de/v1/images/generations \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "湖蓝色调的山谷,清晨薄雾,极简插画风",
"size": "1024x1536",
"n": 1
}'模型切换
若需要使用 2.5 系列模型,只需将上述请求中的 "model": "gpt-image-2" 替换为你密钥分组对应的模型名(例如 "model": "gpt-image-2.5" 或 "model": "gpt-image-2.5-flare")。
响应示例
1. 网址格式(默认)
json
{
"created": 1781837823,
"data": [
{
"url": "https://xxx.png"
}
]
}2. 图片 Base64 编码格式
json
{
"created": 1781837823,
"data": [
{
"b64_json": "<BASE64>"
}
]
}注意事项
- 返回的图片直链网址(
url)默认保存 15 分钟,建议生成完成后尽快下载转存。 - 传
response_format=b64_json时,Base64 数据直接位于data[0].b64_json中。
02 图生图
上传一张或多张参考图进行编辑,请求体为表单(multipart/form-data)。
- 请求方式:
POST - 请求路径:
/v1/images/edits - Content-Type:
multipart/form-data
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
model | 是 | string | 填入你的分组支持的模型:gpt-image-2、gpt-image-2.5、gpt-image-2.5-flare 或 gpt-image-2.5-sunburst |
image / image[] | 是 | file | PNG / JPEG / WebP 文件,可重复传入多张 |
prompt | 是 | string | 编辑要求;多图可用“第一张 / 第二张”指代 |
size | 否 | string | 不传则沿用参考图尺寸;1K 分组最高支持 1K;4K 分组支持 1K / 2K / 4K |
quality | 否 | string | high 分组支持 high;其他分组默认 medium |
n | 是 | integer | 请固定传 1 |
response_format | 否 | string | 返回格式:url(默认)或 b64_json |
请求示例
单张参考图
bash
curl https://img.mzfe.de/v1/images/edits \
-H "Authorization: Bearer <API_KEY>" \
-F "model=gpt-image-2" \
-F "image=@otter.png" \
-F "n=1" \
-F "prompt=给这只海獭戴上一顶贝雷帽"多张参考图
bash
curl https://img.mzfe.de/v1/images/edits \
-H "Authorization: Bearer <API_KEY>" \
-F "model=gpt-image-2" \
-F "image[]=@teapot.png" \
-F "image[]=@duck.png" \
-F "n=1" \
-F "prompt=把第二张图的小鸭子放在第一张图的茶壶旁边"响应示例
网址格式
json
{
"created": 1781837823,
"data": [
{
"url": "https://xxx.png"
}
]
}图片 Base64 编码格式
json
{
"created": 1781837823,
"data": [
{
"b64_json": "<BASE64>"
}
]
}注意事项
- 返回的图片直链网址默认保存 15 分钟,建议尽快下载。
- 传
response_format=b64_json时,图片编码位于data[0].b64_json。