跳到內文
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 版本。見比例和尺寸。

本頁內容