指南
改图(图生图)
用 Cheapest Imagen API 做图生图:把一张或几张参考图发到 /v1/images/edits,用 GPT Image 或 Nano Banana 按提示词修改,支持上传文件和传链接。
把提示词和一张或几张参考图发到 POST /v1/images/edits。所有模型都支持参考图,改图和生成新图扣的积分一样。
上传文件
用表单发送请求。每张参考图重复一次 image[]。
curl https://api.cheapestimagen.com/v1/images/edits \
-H "Authorization: Bearer $YOUR_KEY" \
-F model=nano-banana-2.1 \
-F prompt="把商品放在大理石桌面上,柔和的自然光" \
-F "image[]=@product-front.png" \
-F "image[]=@product-side.png" \
-F size=2048x2048 \
-F response_format=url用 OpenAI 的 SDK:
from openai import OpenAI
client = OpenAI(base_url="https://api.cheapestimagen.com/v1", api_key="YOUR_KEY")
result = client.images.edit(
model="gpt-image-2.6",
image=[open("portrait.png", "rb")],
prompt="把外套换成深绿色,保持脸和背景不变",
response_format="url",
)
print(result.data[0].url)传链接而不是文件
发送 JSON,带一个 images 数组。每一项有一个 image_url,可以是 https: 链接,也可以是 base64 的 data: URL。
curl https://api.cheapestimagen.com/v1/images/edits \
-H "Authorization: Bearer $YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-pro",
"prompt": "把这张线稿变成水彩插画",
"images": [{ "image_url": "https://example.com/sketch.png" }]
}'不支持 file_id,请传 image_url。
限制
| 每次请求的参考图 | 1 到 16 张 |
| 单张图片大小 | 不超过 20 MB |
| 整个请求大小 | 不超过 50 MB |
| 文件类型 | PNG、JPEG、WebP |
超过这些限制会返回 413。
参数
文生图的参数在改图里都能用:n、size、quality、output_format、response_format。另有一个改图专用的参数:
| 字段 | 作用 | 取值 |
|---|---|---|
input_fidelity | 结果在多大程度上保留参考图的细节 | low(默认)、high。GPT Image 2.5、2.6 及其 flare、sunburst 版本支持;其他模型返回 400 |
暂不支持
- 蒙版:不能只重绘图的某一块。请在提示词里写清楚哪些地方要保持不变。
- 透明背景:
background: transparent在所有模型上都返回400。
小技巧
- 主体要保持一致时,多给几个角度的参考图。
- 写清楚什么不能变,比如“保持标签不变”“脸和发型不变”。
- 要 2K、4K 的结果,用 Nano Banana、
gpt-image-2-adobe,或者 flare、sunburst 版本。见比例和尺寸。