GPT-Image 參數與介面差異
了解 GPT-Image 系列模型在圖片生成與編輯介面下的參數差異與使用方式。
根據所選型號調整生成、編輯及輸出參數。完整請求和回應結構請參閱 建立圖片 和 編輯圖片。
適用模型
| 模型 | 支援的介面 |
|---|---|
| gpt-image-2.6-sunburst新 gpt-image-2.6-flare新 gpt-image-2.5-sunburst gpt-image-2.5-flare gpt-image-2 gpt-image-1.5 | OpenAI Images：建立圖片、編輯圖片 |
生成參數差異
| 欄位 | 差異說明 |
|---|---|
quality | 2.6、2.5 支援 auto/low/medium/high/xhigh/max；2、1.5 支援 auto/low/medium/high，皆預設為 auto |
size | 1.5 支援 auto、1024x1024、1024x1536、1536x1024；2、2.5 支援自訂尺寸，邊長須為 16 的倍數且不超過 3840，寬高比為 1:3～3:1，總像素為 655360～8294400；超過 3686400 像素為實驗性尺寸 |
size (2.6) | 支援 auto 或自訂尺寸，寬高為 16 的倍數、寬高比為 1:3～3:1；GIF 另受影格數與總像素預算限制，請勿直接套用靜態圖片的尺寸設定 |
complexity | 2.6 支援 low/medium/high，預設為 high；控制生成前的規劃投入，quality 控制繪製細節，兩者分別設定 |
background | 透明背景須明確設定 transparent，點陣圖輸出使用 png 或 webp；JPEG 不保留透明通道。2 的透明背景為官方預覽功能 |
編輯參數差異
| 欄位 | 差異說明 |
|---|---|
input_fidelity | 1.5 支援 low/high，預設為 low；需要保留輸入細節時選擇 high。2 一律以高保真處理，請省略此欄位；2.6 也應省略，請勿將 1.5 的設定直接套用至新型號 |
markup | 2.5、2.6 支援標註編輯；提供與第一張輸入圖片校正方向後尺寸一致、含透明區域的 PNG 標註圖層，並在提示詞中說明修改內容 |
mask、markup | 擇一使用；輸入多張圖片時作用於第一張圖片。遮罩透過透明區域指定編輯位置，標註圖層則以圈選、箭頭等提示修改位置 |
output_format | 編輯結果使用 png/jpeg/webp；SVG、GIF 輸出請使用建立圖片介面 |
輸出格式差異
| 欄位 | 差異說明 |
|---|---|
output_format | 六款皆支援 png/jpeg/webp，預設為 png；2.6 建立圖片另支援 svg/gif |
output_compression | 僅用於 jpeg/webp，範圍為 0～100；PNG、SVG、GIF 請省略 |
| SVG | 2.6 建立圖片設定 output_format: "svg"、n: 1；不使用串流或中間圖片。將 data[0].b64_json 解碼後儲存為 .svg，內容為 UTF-8 XML |
svg | 用於選擇 SVG 編寫模型，與最上層圖片 model 不同；僅在啟用 SVG 模型選擇時填入 svg.model，否則省略整個物件。svg.reasoning 與圖片 complexity 分別控制 |
| GIF | 2.6 建立圖片設定 output_format: "gif"；不使用串流、中間圖片或自訂壓縮。將 data[].b64_json 解碼後儲存為 .gif |
frame_count | 僅用於 GIF，2～16 影格，預設為 9；影格數、每影格尺寸與 n 共同受總像素預算限制，超限時減少其中一項 |
frame_duration_ms | 僅用於 GIF，20～2000 毫秒，預設為 200，按 10 毫秒取整 |
呼叫範例
將 MODEL_ID 替換為平台提供的完整模型 ID；以下生成、SVG、GIF 範例使用 2.6，標註編輯使用 2.5 或 2.6。
curl 'https://api.agtcloud.ai/v1/images/generations' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"model": "MODEL_ID",
"prompt": "一張簡潔的咖啡館開業海報，標題為 OPEN TODAY，排版清晰",
"quality": "medium",
"complexity": "high",
"size": "1024x1024",
"output_format": "png"
}'