圖生圖
根據提示詞和一張或多張參考圖生成圖片,參考圖可以用表單上傳檔案,也可以傳連結。
根據提示詞和一張或多張參考圖生成圖片,參考圖可以用表單上傳檔案,也可以傳連結。
apiKeyAuthorizationBearer <token>你的 API 金鑰,放在請求標頭裡:Authorization: Bearer <金鑰>。
Idempotency-Key?string你自己訂的一個值,最長 255 個字元。重複送出同一個值不會再次生成和扣費,而是回傳 409。
length <= 255multipart/form-data- body
model*string使用的模型。
"gpt-image-2""gpt-image-2-adobe""gpt-image-2.5""gpt-image-2.5-flare""gpt-image-2.5-sunburst""gpt-image-2.6""gpt-image-2.6-flare""gpt-image-2.6-sunburst""nano-banana-2""nano-banana-2.1""nano-banana-pro""nano-banana-2-1k""nano-banana-2-2k""nano-banana-2-4k""nano-banana-pro-1k""nano-banana-pro-2k""nano-banana-pro-4k"prompt*string圖片內容的描述,最長 32,000 個字元。
length <= 32000n?integer生成幾張。一次請求扣 n 乘以模型積分。1K 最多 10 張,2K 最多 4 張,4K 最多 2 張。
1 <= value <= 101size?stringauto 由模型自己決定(只有一種解析度的模型就用那種)。其餘是 1K、2K、4K 尺寸;每個模型可用哪些解析度見 /zh-tw/models 上它的卡片,同一模型各解析度同價。各尺寸對應的比例見「比例和尺寸」。gpt-image-2-adobe 和 gpt-image-2.5-flare 還能自己填寬高:都是 16 的倍數,單邊不超過 3840 像素,長寬比不超過 3:1,總像素 655,360 到 8,294,400。
"auto""auto""1024x1024""1536x1024""1024x1536""1443x1090""1090x1443""1672x941""941x1672""1408x1120""1120x1408""1920x832""832x1920""1792x896""896x1792""1152x864""864x1152""1280x720""720x1280""1120x896""896x1120""1456x624""624x1456""1536x768""768x1536""2048x2048""2048x1360""1360x2048""2304x1728""1728x2304""2048x1152""1152x2048""2240x1792""1792x2240""2912x1248""1248x2912""3072x1536""1536x3072""2048x688""688x2048""2880x2880""3504x2336""2336x3504""3264x2448""2448x3264""3840x2160""2160x3840""3200x2560""2560x3200""3840x1648""1648x3840""3840x1920""1920x3840""3840x1280""1280x3840""2048x512""512x2048""3072x384""384x3072""4096x1024""1024x4096""6144x768""768x6144""8192x2048""2048x8192""12288x1536""1536x12288"quality?string算圖品質。gpt-image-2-adobe 以及 flare、sunburst 版本按檔位出圖;其他 GPT 模型自己決定品質,Nano Banana 忽略這個參數。xhigh 和 max 只有 gpt-image-2.5-sunburst 支援。所有檔位價格相同。
"auto""auto""low""medium""high""xhigh""max"background?string目前沒有模型能直接生成透明背景,傳 transparent 會回傳 400。auto 和 opaque 所有模型都能用。
"auto""auto""opaque"output_format?string回傳圖片的檔案格式。gif 用於 gpt-image-2.6 及其 flare、sunburst 版本,svg 只用於 gpt-image-2.6。png、jpeg、webp 所有模型都能用。
"png""png""jpeg""webp""gif""svg"output_compression?integerjpeg、webp 的品質,0 到 100,預設 100。
0 <= value <= 100moderation?string對提示詞和結果的審核嚴格程度。low 更寬鬆。
"auto""auto""low"response_format?stringb64_json 在回傳裡直接帶圖片資料;url 回傳圖片連結,保存 72 小時。
"b64_json""b64_json""url"async?boolean設為 true 時請求在背景執行:立刻回傳 202 和一個任務,之後用 GET /images/tasks/{id} 取結果。圖片以連結回傳,所以 response_format 只能是 url 或不填。請求標頭 Prefer: respond-async 效果相同。
falsewebhook_url?string搭配 async 使用:一個 https:// 位址,任務結束時我們向它 POST 一次任務內容(和 GET /images/tasks/{id} 回傳的 JSON 相同),最多嘗試 3 次。傳 webhook_secret 可以讓回呼帶簽章;不傳的話,收到後請用你的金鑰再查一次任務來確認。
uriwebhook_secret?string搭配 webhook_url 使用:你自己訂的一個密鑰,16 到 128 個字元。回呼請求會帶上 x-webhook-signature: t=<秒級時間戳>,v1=<十六進位>,其中十六進位字串是用這個密鑰對 <t>.<請求本文> 做 HMAC-SHA256 的結果。
16 <= length <= 128image[]*array<>參考圖:PNG、JPEG 或 WebP,1 到 16 張,單張不超過 20 MB,合計不超過 50 MB。
1 <= items <= 16input_fidelity?string結果在多大程度上保留參考圖的細節。gpt-image-2 不接受這個參數。
"low""high"生成的圖片。
application/json- response
created*integer生成時間,Unix 時間戳(秒)。
data*array<>curl -X POST 'https://api.cheapestimagen.com/v1/images/edits' \ -F 'model=gpt-image-2' \ -F 'prompt=string' \ -F 'image[]=[ "string"]'{ "created": 0, "data": [ { "b64_json": "string", "url": "http://example.com" } ]}