GPT Image 2.6(轻量线路)
gpt-image-2.6 的完整调用说明。接口与 OpenAI Images API 格式一致,可直接用 OpenAI SDK。图片是同步调用:请求完成后直接返回图片。
接入信息
| 项目 | 值 |
|---|---|
| 接口根地址 | https://api.a7w.cn/api/v1 |
OpenAI SDK 的 base_url | https://api.a7w.cn/api/v1 |
| 鉴权请求头 | Authorization: Bearer <你的 API 密钥> |
| 模型 ID | gpt-image-2.6 |
- 客户端超时建议设 180 秒以上:一张图通常 20–50 秒,GIF 和多张图更久;经过网关或 CDN 时它们的超时也要放宽。
- 三个名字
gpt-image-2.6/-sunburst/-flare参数、限制、返回格式都一样,不能通过名字选速度或画质档位。
价格
| 项目 | 价格 |
|---|---|
| 单价 | 6 点 / 张(¥0.06) |
| 张数 | 价格 |
|---|---|
| 1 张 | 6 点(¥0.06) |
| 2 张 | 12 点(¥0.12) |
| 3 张 | 18 点(¥0.18) |
| 4 张 | 24 点(¥0.24) |
- 按张计费,与尺寸、质量、输出格式都无关;
- 按
data里实际返回的张数计费,可能和n不一致(n=2只回 1 张就收 1 张); - 参数错误、请求失败、没返回图片 → 不扣费;
- 客户端中途断开或流式中断 → 仍按请求张数计费。
文生图
POST https://api.a7w.cn/api/v1/images/generations,请求体 JSON。
| 参数 | 必填 | 说明 |
|---|---|---|
model | 是 | gpt-image-2.6 |
prompt | 是 | 提示词 |
n | 否 | 生成张数 1–4,默认 1 |
size | 否 | 图片尺寸,见下;默认 auto |
response_format | 否 | b64_json(默认)或 url |
output_format | 否 | png(默认)、jpeg、webp、gif |
output_compression | 否 | 0–100,只对 jpeg、webp 生效 |
background | 否 | auto(默认)、transparent、opaque |
quality | 否 | auto/low/medium/high/xhigh/max,仅作提示,不影响价格 |
尺寸
| 写法 | 结果 |
|---|---|
不传或 auto | 由模型决定,常见 1448×1086、1254×1254 |
1k / 2k / 4k | 1024×1024 / 2048×2048 / 3840×2160 |
宽x高,如 1536x1024 | 按请求尺寸返回 |
自定义尺寸需同时满足(否则 400,不扣费):
- 宽高都是 16 的倍数;
- 长边与短边比 不超过 3:1;
- 单边 不超过 3840;
- 总像素 655,360 – 8,294,400。
背景
opaque:不透明;transparent:尽量透明,不保证每次成功,以响应background为准;不能和jpeg一起用(400);auto:不处理。
示例
curl -X POST https://api.a7w.cn/api/v1/images/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.6",
"prompt": "一只橘猫在窗台晒太阳",
"size": "1024x1024",
"n": 1
}'
Python(OpenAI SDK):
import base64
import requests
from openai import OpenAI
client = OpenAI(base_url="https://api.a7w.cn/api/v1", api_key="sk-xxxx", timeout=180)
result = client.images.generate(
model="gpt-image-2.6",
prompt="一只橘猫在窗台晒太阳",
size="1024x1024",
n=1,
)
for i, image in enumerate(result.data):
if image.b64_json:
data = base64.b64decode(image.b64_json)
else:
data = requests.get(image.url, timeout=120).content
ext = "gif" if data[:3] == b"GIF" else "png"
with open(f"image-{i}.{ext}", "wb") as f:
f.write(data)
图生图
POST https://api.a7w.cn/api/v1/images/edits,请求体 multipart/form-data(curl 用 -F 自动设置,不要手写 Content-Type)。
| 字段 | 必填 | 说明 |
|---|---|---|
model | 是 | gpt-image-2.6 |
prompt | 是 | 想怎么改图 |
image | 是 | 参考图文件;多张时重复传 image[],每次最多 20 张 |
mask | 否 | 蒙版文件(当作提示,不保证严格贴合边界) |
markup | 否 | 标注层文件,见下节 |
| 其他 | 否 | size/n/response_format/output_format/output_compression/background/quality 同文生图 |
整个请求建议 不超过 50 MB。
curl -X POST https://api.a7w.cn/api/v1/images/edits \
-H "Authorization: Bearer $API_KEY" \
-F model=gpt-image-2.6 \
-F "prompt=把第二张图里的帽子戴到第一张图的猫头上" \
-F size=1024x1024 \
-F "image[]=@cat.png" \
-F "image[]=@hat.png"
Python:
with open("cat.png", "rb") as cat, open("hat.png", "rb") as hat:
result = client.images.edit(
model="gpt-image-2.6",
image=[cat, hat],
prompt="把第二张图里的帽子戴到第一张图的猫头上",
size="1024x1024",
)
用标注指定修改位置
图上圈出要改的地方,再用提示词说明怎么改。图里有相似物体、位置难用文字描述时更准。计费和普通图生图相同。
- 第一张图传原图;
- 另做一张透明背景 PNG 作为标注层(只画圈、箭头),用
markup传,不要合并到原图; prompt里写清改成什么、哪些保持不变。
标注层要求:
- 只对第一张图生效,其他图仍作参考图;
- 必须是含透明像素的 PNG,宽高与第一张图相同(带方向信息的照片按旋转后宽高算);
- 第一张图和标注层都不能超过 16,777,216 像素,标注层不超过 50 MB;
- 每次只能一个标注层,不能和
mask同用,也不支持file_id; - 不符合要求 → 400,不扣费。
curl -X POST https://api.a7w.cn/api/v1/images/edits \
-H "Authorization: Bearer $API_KEY" \
-F model=gpt-image-2.6 \
-F "prompt=把红圈里的太阳换成弯月,其他地方保持不变" \
-F "image=@photo.png" \
-F "markup=@overlay.png"
标记只用来指位置,一般不会留在结果里;这不是局部锁定,整张图会重新生成。
GIF 动图
传 output_format=gif,或在提示词里明确要 GIF 动图,文生图和图生图都支持。
curl -X POST https://api.a7w.cn/api/v1/images/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-image-2.6","prompt":"一只橘猫在挥手","output_format":"gif","response_format":"url"}'
- 尺寸和帧数由模型决定(实测约 8–16 帧,边长 170–900 像素);
size、frame_count、frame_duration_ms对 GIF 不生效; url模式返回.gif链接;b64_json解码后就是 GIF;- 按一张计费;
- 偶尔只出静态图(返回 PNG,
output_format写png); background=transparent不能和output_format=gif同用(400);- 显式传
jpeg/webp时返回首帧静态图; - 耗时更长,最长见过约 130 秒。
返回结果
{
"created": 1793900000,
"data": [
{ "b64_json": "iVBORw0KGgo...", "revised_prompt": "一只橘猫在窗台晒太阳", "width": 1024, "height": 1024 }
],
"usage": { "input_tokens": 13, "output_tokens": 1056, "total_tokens": 1069 },
"background": "auto",
"output_format": "png",
"quality": "auto",
"size": "1024x1024"
}
data每项带b64_json或url,两种都要处理;usage仅供参考,费用按张计算;n > 1时data内容准确,顶层size/output_format可能是请求值。
图片链接:有效期约 3 小时,请及时下载;请原样使用(追加查询参数会 404);下载不需要密钥;用 Python 标准库 urllib 需自设 User-Agent(默认值会被拒 403),requests/httpx/curl/浏览器不受影响。
流式
传 stream: true 时响应为 SSE,生成完成后只有一个事件:
event: image_generation.completed
data: {"type":"image_generation.completed","b64_json":"iVBORw0KGgo...","usage":{...}}
图生图事件名是 image_edit.completed。流式只能配 b64_json,配 url 会返回 502,不扣费。
与标准 Images 接口的差异
| 项目 | 这里的行为 |
|---|---|
n | 最大 4 |
response_format | 支持 url |
data[].width / height | 额外返回 |
output_format=gif | 支持,帧数/时长/尺寸由模型决定,偶尔只出静态 PNG |
output_format=svg | 返回 400;不支持 SVG,提示词要 SVG 也只返回位图 |
complexity / frame_count / frame_duration_ms / moderation / partial_images / input_fidelity | 传了不报错,但不起作用 |
markup 的 file_id | 不支持,请用文件上传或 image_url |
错误
| 情况 | 状态码 | param | 提示 |
|---|---|---|---|
| 尺寸不符合要求 | 400 | size | width/height must be multiples of 16 等 |
output_format 不支持 | 400 | output_format | Supported: 'png','jpeg','webp','gif' |
| 透明背景配 jpeg/gif | 400 | output_format | Transparent backgrounds are only supported with 'png' or 'webp' |
background 不支持 | 400 | background | Supported: 'transparent','opaque','auto' |
n 超范围 | 400 | n | expected an integer in [1, 4] |
output_compression 超范围 | 400 | output_compression | expected an integer in [0, 100] |
| 图片无法解析 | 400 | image | Invalid input image: ... |
| 标注层不合格 | 400 | markup | markup must be a PNG with transparent pixels |
缺 prompt | 422 | String should have at least 1 character | |
| 模型名写错/无权限 | 404 | The model xxx does not exist or you do not have access to it |
内容审核拒绝会返回错误并说明原因,不扣费。