跳到正文
Cheapest Imagen
指南

改图(图生图)

用 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 版本。见比例和尺寸。

本页内容