图像生成:文生图与图生图
图像是同步接口:一次请求直接返回成图(通常 20~70 秒),无需轮询。两种用法——文生图(/v1/images/generations,JSON)与图生图 / 改图(/v1/images/edits,multipart 表单): 传原图 + 一句改图指令,即可换风格、改天气、加删元素,构图与主体可保持。 在售三款 gpt-image 模型共用同一套调用方式,换 model 名即可。
在售型号
控制台选「生图 · 标准」或「生图 · 极速」后,下列模型名须一字不差。价目见 模型与价格。
gpt-image-2gpt-image-2.5-flaregpt-image-2.5-sunburst快速上手
网关地址 https://gw.aiapiway.com/v1,密钥即现有 sk- 密钥(分组须包含生图模型)。gpt-image 系列返回的是 data[0].b64_json(base64 图片,不是 URL),解码保存即可; 客户端超时请设 ≥120 秒。示例以 gpt-image-2 为例,换成 gpt-image-2.5-flare / gpt-image-2.5-sunburst 即可。
import base64
from openai import OpenAI
client = OpenAI(base_url="https://gw.aiapiway.com/v1", api_key="sk-aiapiway-****")
# ① 文生图(model 也可换成 gpt-image-2.5-flare / gpt-image-2.5-sunburst)
img = client.images.generate(
model="gpt-image-2",
prompt="一只卡通橘猫坐在草地上",
size="1024x1024", # 也可用 1536x1024 / 1024x1536;勿指望 2K/4K
quality="low", # 可传 low/medium/high;当前线路档差可能不明显
# n=1, # 请固定 1;n>1 可能仍只返回 1 张
)
open("out.png", "wb").write(base64.b64decode(img.data[0].b64_json))
# ② 图生图(改图):传本地文件,SDK 自动走 multipart
edit = client.images.edit(
model="gpt-image-2",
image=open("原图.jpg", "rb"),
prompt="把画面改成雪天,保持构图不变",
size="1024x1024",
quality="low",
)
open("edited.png", "wb").write(base64.b64decode(edit.data[0].b64_json))参数参考
model须一字不差:gpt-image-2 / gpt-image-2.5-flare / gpt-image-2.5-sunburst。密钥须选「生图 · 标准」或「生图 · 极速」(或含上述模型的分组)。prompt文生图 = 画面描述;图生图 = 改图指令(想保持构图/主体,请在指令里明说,如「保持构图不变」)。size已验证可用:"1024x1024"(方图)、"1536x1024"(横)、"1024x1536"(竖)。更大尺寸(如 2048x2048)可能仍返回成功,但不会得到真实 2K——请勿按 2K/4K 理解。quality可传 low / medium / high。当前线路上档位差异可能不明显,调试建议固定 low;以实际返回与账单为准。n生成张数。生产请固定 n=1:传 n>1 时接口可能仍成功,但当前线路通常只返回 1 张。多张请并发多次 n=1。image(仅图生图)原图文件(jpg/png),multipart 表单字段——curl 用 -F image=@文件,SDK 直接传文件对象;不是 JSON 字段。计费
三款生图(gpt-image-2 / 2.5-flare / 2.5-sunburst)均为按次结算(同步接口,无预扣冻结),明细见 模型与价格。这是平台按张价:与 OpenAI 官方「按 token、且 2.5 高于 2」的价目不是同一口径;当前三款同档展示。 响应里可能仍带 tokens 字段,仅供对照,不以官方 token 单价重算实付。 每次调用的实付以控制台账单明细为准。
常见失败与对策
图生图报 400 / 请求格式错误?›
/v1/images/edits 是 multipart 表单接口:curl 必须用 -F(不是 -d 发 JSON),SDK 传文件对象(open(...,"rb") / fs.createReadStream)。把 JSON 语法照搬过去是最常见的错。
响应里没有图片 URL?›
gpt-image 系列固定返回 base64(data[0].b64_json),不提供 URL——解码保存为 png 即可,示例代码里已包含解码两行。
请求超时了,钱扣了吗?›
生成通常 20~70 秒,客户端超时请设 ≥120 秒。若客户端提前断开,服务端已完成的生成仍会结算,建议加大超时而不是快速重试,避免重复生成重复计费。
报「无可用渠道」或 not supported on the Chat Completions endpoint?›
两个原因:① 密钥分组不含生图模型——请用「生图 · 标准 / 极速」密钥,model 用 gpt-image-2 或 2.5-flare / sunburst;② 接口用错——生图必须走 images 接口,不能用 chat/completions。
站内生图价是不是 OpenAI 官方价?›
不是同一口径。OpenAI 官方按 token(且 2.5 高于 2);本站三款生图按次结算、现同档展示。账单以控制台实付为准,勿用官方 token 单价自行换算。
传了 2048 / 2K / 4K,为什么看起来还是普通分辨率?›
当前线路已验证的可用 size 是 1024x1024、1536x1024、1024x1536。传入更大尺寸时接口可能仍返回 200,但不会得到真实 2K/4K 像素——请勿按高清增强版理解。
传了 n=2 或 n=4,为什么还是只有一张?›
当前线路以 n=1 为准:n>1 可能被忽略,响应里通常仍只有 data[0]。要多张请并发多次 n=1(极速档也请如此),不要依赖单次请求里的 n。
quality=high 有没有用?›
字段可传且一般不报错;当前线路上 low/medium/high 的差异可能不明显。调试固定 low,成品可再试 medium/high,以返回图与账单为准。
一张图要等很久?标准与极速有什么区别?›
控制台密钥可选「生图 · 标准」或「生图 · 极速」。极速单张通常更快(约 20 秒级),但请固定 n=1。调试建议 size=1024x1024、quality=low,客户端超时 ≥120 秒。
一次想出 4 张图怎么最快?›
请并行发 4 次 n=1(墙钟常接近单张耗时)。不要依赖单次请求里的 "n":4——当前线路多半仍只回 1 张。