指南
改圖(圖生圖)
用 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 版本。見比例和尺寸。