OpenAI 11 月 4 日發布 GPT-Image-2.6 Sunburst 與 Flare 之後,Image API 裡 GIF、SVG 和 markup 編輯的請求 JSON 該怎麼寫?

截至 2026 年 11 月 5 日:generations 用 output_format gif/svg 與 frame_*;edits 用 markup 物件。GPT 圖像模型只回傳 b64_json,勿傳 response_format url。

先給結論: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 分表校驗。