GPT Image 2.6(轻量线路)

gpt-image-2.6 的完整调用说明。接口与 OpenAI Images API 格式一致,可直接用 OpenAI SDK。图片是同步调用:请求完成后直接返回图片。

接入信息

项目值
接口根地址https://api.a7w.cn/api/v1
OpenAI SDK 的 base_urlhttps://api.a7w.cn/api/v1
鉴权请求头Authorization: Bearer <你的 API 密钥>
模型 IDgpt-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 / 4k1024×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",
    )

用标注指定修改位置

图上圈出要改的地方,再用提示词说明怎么改。图里有相似物体、位置难用文字描述时更准。计费和普通图生图相同。

  1. 第一张图传原图;
  2. 另做一张透明背景 PNG 作为标注层(只画圈、箭头),用 markup 传,不要合并到原图;
  3. 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提示
尺寸不符合要求400sizewidth/height must be multiples of 16 等
output_format 不支持400output_formatSupported: 'png','jpeg','webp','gif'
透明背景配 jpeg/gif400output_formatTransparent backgrounds are only supported with 'png' or 'webp'
background 不支持400backgroundSupported: 'transparent','opaque','auto'
n 超范围400nexpected an integer in [1, 4]
output_compression 超范围400output_compressionexpected an integer in [0, 100]
图片无法解析400imageInvalid input image: ...
标注层不合格400markupmarkup must be a PNG with transparent pixels
缺 prompt422String should have at least 1 character
模型名写错/无权限404The model xxx does not exist or you do not have access to it

内容审核拒绝会返回错误并说明原因,不扣费。

同类文章