先給結論:2026 年 11 月 4 日 OpenAI 在 Image API 上線 gpt-image-2.6-sunburst 與 gpt-image-2.6-flare。生成仍走 POST /v1/images/generations,編輯走 POST /v1/images/edits。2.6 在 2.5 之上新增可調 complexity、output_format: svg|gif,以及 2.5/2.6 都支援的 markup 標註層編輯。GPT 影像模型響應始終是 data[].b64_json,不要傳已退役的 response_format: url。
這篇按 2026 年 11 月 5 日寫,依據 11 月 4 日 changelog 與 Image generation / Image prompting 指南。兩天前本站寫過《Anthropic message threads》——那邊是 Messages 增量 JSON;這邊是影像端點裡新增輸出格式與編輯欄位。若你仍在 2.5 快照上跑通流程,把 model 換成 2.6 並單獨為 GIF/SVG/markup 建 JSON Schema 即可。
Sunburst 與 Flare 及共用欄位
gpt-image-2.6-flare 偏延遲;gpt-image-2.6-sunburst 偏細節與編輯精度。兩者都支援 complexity(low / medium / high,省略時檔案預設 high)、quality(至 max)、透明 background,以及 raster 的 png / jpeg / webp。
{
"model": "gpt-image-2.6-flare",
"prompt": "Flat vector icon of a lantern, centered",
"size": "1024x1024",
"quality": "high",
"complexity": "medium",
"output_format": "png",
"n": 1
}
僅 Image API 直接設 model;Responses 裡影像工具仍用 2.5/2.6 模型 id 寫在 tool 的 model 欄位。Chat Completions 不支援這兩個 2.6 快照。
GIF 生成請求 JSON
只在 /v1/images/generations 設 output_format: "gif";編輯端點不支援 GIF。用 frame_count(2–64,預設 9)與 frame_duration_ms(20–2000,預設 200,編碼時四捨五入到 10 ms)控制動畫。GIF 不支援 streaming、partial images、output_compression 或 prompt_rewriter。
{
"model": "gpt-image-2.6-sunburst",
"prompt": "Paper lantern swaying in a loop, same start and end pose",
"output_format": "gif",
"frame_count": 9,
"frame_duration_ms": 200,
"size": "1024x1024",
"n": 1
}
size 描述每一幀的畫素;幀數 × 單幀尺寸 × n 不能超過模型總畫素預算。超限時優先減 frame_count 或尺寸,或用 auto 讓 API 選合法幀大小。賬戶需具備所選模型的 GIF 預覽許可權。
SVG 生成請求 JSON
同樣在 generations 上設 output_format: "svg"。n 必須為 1。SVG 不支援 streaming、partial、output_compression、prompt_rewriter,且不能作為 raster 編輯輸入。解碼 data[0].b64_json 得到 UTF-8 XML;返回的是靜態向量,不含指令碼或外鏈資源。
{
"model": "gpt-image-2.6-sunburst",
"prompt": "Minimal bakery logo, wheat and rolling pin, single color",
"output_format": "svg",
"quality": "high",
"complexity": "high",
"size": "1024x1024"
}
響應可能帶 svg_usage(SVG 作者模型的 token),與 raster 的 usage 分開;對賬時不要把兩類 usage 混進同一 JSON Schema。
markup 引導編輯 JSON
2.5 與 2.6 Sunburst/Flare 在 /v1/images/edits 支援 markup:與第一張輸入圖等大的透明 PNG 標註層。JSON 請求用 images 陣列放底圖;markup 為物件,且恰好包含 image_url 或 file_id 之一(可 HTTPS 或 base64 data URL)。
{
"model": "gpt-image-2.6-flare",
"prompt": "Replace the circled vase with blue ceramic, keep kitchen lighting",
"images": [
{"image_url": "https://cdn.example/kitchen.webp"}
],
"markup": {
"image_url": "data:image/png;base64,iVBORw0KGgo..."
},
"size": "1536x1024"
}
markup 不能與 mask 或 prompt_rewriter 同請求。標註只作用於第一張輸入圖;額外 images 條目作參考。Multipart 上傳時 markup 是檔案欄位——那種形態沒有 JSON 體,別和上面的 JSON 示例混在一個 Schema 裡。
響應 JSON 與 usage
成功響應頂層有 created(Unix 秒)與 data 陣列。每項至少含 b64_json;GIF/SVG 同樣走 base64,客戶端解碼後寫 .gif 或 .svg。GPT 影像模型不返回 revised_prompt 或 url。
使用者可修正錯誤可能帶 error.type: image_generation_user_error 與穩定 error.code(如 moderation_blocked,可選 moderation_details)。這類錯誤不要原樣重試——改 prompt 或輸入後再發。
本機校驗請求體
建議至少四套 Schema:generations/raster、generations/gif、generations/svg、edits/markup-json。用 JSON 校驗 抓 frame_count 出現在非 GIF 請求、或 markup 物件同時含 image_url 與 file_id 等組合錯誤。
常見問題 FAQ
2.6 能在 Responses API 裡直接當頂層 model 嗎?
不能。2.6 只掛在 Image API 的 generations/edits;Responses 仍在 tool 裡指定 gpt-image-2.6-*。
編輯端點能輸出 GIF 或 SVG 嗎?
不能。GIF 與 SVG 僅 generations;編輯只出 raster。
還能用 response_format url 嗎?
GPT 影像模型不支援;傳了也會被忽略或報錯。只用 b64_json。
markup 和 mask 能一起傳嗎?
不能。二選一;markup 是透明 PNG 標註,mask 是另一套編輯語義。
frame_count 在編輯 JSON 裡合法嗎?
不合法。僅 output_format 為 gif 的 generations 請求可用。
和 ChatGPT 裡一鍵 GIF 是同一 JSON 嗎?
產品 UI 封裝了 prompt;API 仍需顯式 output_format 與幀參數,並受組織許可權約束。
總結
11 月 4 日的 2.6 把「模型 id + complexity」與「output_format / frame_* / markup」拆清楚:Sunburst/Flare 選延遲還是精度,JSON Schema 按 generations 與 edits 分表校驗。