Appearance
图像生成
使用 OpenAI 兼容的 /v1/images/generations(文生图)与 /v1/images/edits(图生图 / 局部编辑)接口。
| 模型 | 特点 | 价格(元/M tokens) |
|---|---|---|
gpt-image-2 | 上一代旗舰,画质、编辑与人脸保真强,出图较慢 | 47.45 / 284.7 |
gpt-image-2.5-flare | OpenAI 新一代,速度约为 GPT Image 2 的一半;品质六档 low / medium / high / xhigh / max / auto | 47.45 / 284.7 |
注意
gpt-image-1 上游已退役(2026-08-29 下架),请改用 gpt-image-2 或 gpt-image-2.5-flare。
出图尺寸(1K / 2K / 4K)
size 传 auto 或 宽x高;不传时按上游默认(约 1024×1024)。自定义尺寸的约束:
- 宽、高都必须能被 16 整除;
- 宽高比在 1:3 ~ 3:1 之间;
- 上限 3840×2160;超过 2560×1440 的部分上游标注为实验性,可能不稳定或失败。
| 档位 | 示例 size | 说明 |
|---|---|---|
| 1K(长边 ≤1536) | 1024x1024、1536x1024、1024x1536 | 默认档,速度最快 |
| 2K(长边 1537–2048) | 2048x2048、2048x1152、1152x2048 | 实测出图 2048×2048 |
| 4K(长边 >2048) | 2560x1440、3840x2160、2160x3840 | 上限 3840×2160;>2560×1440 为实验性档 |
提示
分辨率由 size 直接决定,不需要换模型名(我们只有 gpt-image-2 / gpt-image-2.5-flare 两个图像模型,不存在 -2k / -4k 之类单独型号)。2K / 4K 是模型原生档位:size 决定实际出图像素(不是把 1024 放大),清晰度随之提升。个别尺寸上游会拒绝并返回 400 size_not_supported,换相邻尺寸即可。品质由 quality 控制,越高越慢也越贵。
文生图(Python)
from openai import OpenAI
client = OpenAI(
base_url="https://novalinkchina.com/v1",
api_key="your-key-here"
)
resp = client.images.generate(
model="gpt-image-2.5-flare",
prompt="a red apple on a white background",
size="2048x2048",
quality="high",
n=1
)
print(resp.data[0].b64_json)文生图(cURL)
curl https://novalinkchina.com/v1/images/generations \
-H "Authorization: Bearer your-key-here" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-image-2.5-flare","prompt":"a red apple","n":1,"size":"2048x2048","quality":"high"}'图生图 / 编辑(cURL)
通过 /v1/images/edits 传入参考图(可选 mask 指定修改区域),尺寸与品质参数同上:
curl https://novalinkchina.com/v1/images/edits \
-H "Authorization: Bearer your-key-here" \
-F model=gpt-image-2.5-flare \
-F prompt="sharpen this into a product poster, keep the mark" \
-F size=2048x2048 \
-F quality=high \
-F image=@input.png费用参考
图像按 token 计费(输入文本 / 参考图 token + 输出图像 token)。尺寸档位与品质越高,输出 token 越多、花费越高;以实际扣费为准(请求日志里可看到用量)。实测样本(2026-09 售价口径):
| 模型 | size | quality | 约花费(元/张) |
|---|---|---|---|
gpt-image-2.5-flare | 2048x2048 | low | 约 0.13 |
gpt-image-2.5-flare | 不传(默认档) | low | 约 0.09 |
gpt-image-2.5-flare | 不传(默认档) | high | 约 0.44 |
注意
- 生成过程中任何中断或失败,一旦发起都会计费(上游已消耗 token)。
- 客户端超时请设为 ≥10 分钟。模型通常 20–60 秒出图,但 2K / 4K 的响应体更大(实测 2K 响应体 5.5–6.2 MB、解码后 PNG 4.1–4.7 MB;4K 更大),弱网下下载更慢;请先完整接收响应再解析 base64,否则容易得到「下载被截断」的图片。
- 只需预览或网络较差时,可用
output_format指定jpeg/webp减小体积(默认png)。 - 避免使用仍在世的艺术家姓名(如「宫崎骏」),可能触发内容过滤导致失败;可用「吉卜力风格」等风格描述替代。
