GPT Image 2.6

透過 SeedRouter 的非同步影像 API，使用 GPT Image 2.6 生成與編輯影像、製作 GIF 動畫並要求 SVG 輸出。

GPT Image 2.6 接受文字提示詞與選用的參考圖。向 POST /v1/images/generations 提交一次、保留任務 ID，再輪詢 GET /v1/tasks/{id} 取得結果。完成的檔案會以 URL 回傳。

模型 ID 與價格

使用 GET /v1/models 查看你的 key 可用的模型。已設定的 Sunburst ID 為 gpt-image-2.6-sunburst-official 與 gpt-image-2.6-sunburst。Flare ID 若有列出，也適用相同的參數契約。裸模型 ID 使用其 Default 群組；其他群組則使用探索介面顯示的 model:group ID。

請參閱目前價格與 Playground。按 token 計費的模型依實際用量結算；按張計費的模型使用設定的單張價格。SVG 回應會在 svg_usage 中分開回報程式碼撰寫模型的 token，並依該模型本身在 SeedRouter 的價格計費。

生成影像

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-sunburst-official",
    "prompt": "A red paper crane on a pale blue table, soft daylight",
    "size": "1024x1024",
    "quality": "low",
    "complexity": "high"
  }'

回應包含一個 id。請輪詢該 ID，不要重新提交生成請求：

curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

完成時，output.data 包含帶有 url 的物件。請下載該 URL，保留原始檔案格式，以及 GIF 的所有動畫影格。失敗的任務帶有 error，且不計費。請參閱任務狀態與輪詢。

參數

共有 18 個頂層欄位。只有 model 和 prompt 必填。選填欄位接受 null，效果與省略相同。未知欄位會被捨棄。受支援欄位的無效值會在影像生成前被驗證攔截。

欄位	型別	預設值與限制
`model`	string	必填；使用你的 key 可用的 ID。
`prompt`	string	必填，不可為空白，最多 32,000 個 Unicode 字元。
`n`	integer	1；範圍 1–10。SVG 須為 1。
`size`	string	`auto` 或 `WIDTHxHEIGHT`。請參閱下方尺寸規則。
`quality`	string	預設 `auto`；也可用 `low`、`medium`、`high`、`xhigh`、`max`。
`background`	string	預設 `auto`；也可用 `opaque`、`transparent`。JPEG 不支援透明。
`output_format`	string	預設 `png`；也可用 `jpeg`、`gif`、`svg`。不提供 WebP 輸出。
`output_compression`	integer	JPEG 預設為 100；範圍 0–100。僅搭配 `output_format: "jpeg"` 傳入。
`moderation`	string	預設 `auto`；也可用 `low`。公開 Playground 中的 `low` 僅限 API 使用。
`complexity`	string	預設 `high`；也可用 `low`、`medium`。控制規劃強度，不另收費。
`frame_count`	integer	9；範圍 2–16。僅限 GIF。
`frame_duration_ms`	integer	200；至少 20 毫秒，無上限。僅限 GIF；編碼器會四捨五入至最接近的 10 ms，並將每格顯示時間限制在 655,350 ms 以內。
`svg`	object	預設省略。可選擇程式碼撰寫模型；詳見下方。
`images`	array	1–16 個形如 `{"image_url":"https://..."}` 的物件；傳入即切換為編輯。
`mask`	object	`{"image_url":"https://..."}`。須搭配 `images`；不可與 `markup` 併用。
`markup`	object	`{"image_url":"https://..."}`。須搭配 `images`；不可與 `mask` 併用。
`safety_identifier`	string	選填的穩定終端使用者識別碼，最長 128 字元。非空值會優先於 `user` 使用。
`user`	string	已棄用的選填終端使用者識別碼；不會顯示於 Playground，也不會自動填入。

參考圖 URL 必須使用 HTTP 或 HTTPS，且不得包含憑證。不接受檔案 ID、內嵌 base64 或 multipart 上傳；請先上傳檔案，再提供公開 URL。請求使用非同步任務輪詢，而非 stream 或 partial_images。此契約不提供 input_fidelity、response_format 與 prompt_rewriter。

影像尺寸

生成 PNG、JPEG 與 SVG 參考圖時，每個維度都須為 16 的倍數，且不得超過 3840 像素。總像素須為 655,360–8,294,400，長寬比介於 1:3 到 3:1。例如：1024x1024、1536x1024、2160x3840、2880x2880。

GIF 的尺寸須為 16 的正整數倍，或使用 auto。GIF 有獨立的像素總預算，由影格數、每格尺寸與 n 共用；OpenAI 尚未公布確切上限。512x512 GIF 不適用靜態影像的最小像素規則。

GIF 動畫

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A red paper crane flapping its wings in a seamless loop on pale blue",
  "output_format": "gif",
  "size": "512x512",
  "quality": "low",
  "frame_count": 4,
  "frame_duration_ms": 200
}

GIF 可以從提示詞生成，也可以根據參考圖要求生成。請勿搭配遮罩或壓縮設定。能否使用預覽功能，可能取決於所選模型的存取權限。

文件差異，核對日期：2026 年 11 月 5 日： OpenAI 的影像生成指南列出 2–64 格與 20–2000 ms，並表示編輯端點不會回傳 GIF。Images API 參考文件則列出 2–16 格、每格顯示時間無上限，且編輯支援 GIF 輸出。2026 年 11 月 5 日的上游請求結果符合參考文件：17 格遭拒絕，3,000 ms 每格則獲接受。本 API 遵循參考文件。

SVG

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A simple geometric red paper-crane logo, clean editable vector paths",
  "output_format": "svg",
  "n": 1
}

SVG 僅支援生成，並要求 n: 1。請勿傳入影像、遮罩、標記圖或壓縮設定。檔案為包含向量形狀的靜態 UTF-8 XML；不支援指令碼、外部資源及內嵌點陣影像。

可選擇程式碼撰寫模型時，加入 svg: {"model":"YOUR_AUTHOR_MODEL_ID"}。明確傳入 svg 物件時，model 不可為空。你也可以將 svg.reasoning.effort 設為 none、minimal、low、medium、high、xhigh 或 max；支援哪些值由所選的程式碼撰寫模型決定。省略 reasoning 即使用該模型的預設值。OpenAI 並未公布程式碼撰寫模型允許清單或通用預設值。若無法選擇程式碼撰寫模型，請省略整個 svg 物件。

完成的結果可能包含 svg_usage，其中有 model、input_tokens、output_tokens、reasoning_tokens 和 total_tokens。這與影像的 usage 分開統計，並非額外的影像 token 數量。

參考圖、遮罩與標記圖

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "Replace the marked background with a pale blue studio backdrop",
  "images": [{"image_url":"https://example.com/reference.png"}],
  "markup": {"image_url":"https://example.com/transparent-markup.png"},
  "output_format": "png",
  "complexity": "low"
}

參考圖支援 PNG、JPEG 與 WebP，每張最多 50 MB。遮罩與標記圖須為 PNG，且須符合第一張參考圖調整方向後的尺寸。標記圖必須包含透明像素；標記圖與第一張參考圖都不得超過 16,777,216 像素，標記圖最多為 50 MB。遮罩與標記圖不可併用。

回應欄位

完成的影像輸出包含 created、data: [{url}]，以及有回報時的 size、quality、background、output_format、usage、svg_usage 和 safety_identifier。usage 可能細分文字/影像輸入與輸出 token，以及快取輸入。公開輸出不包含 base64 影像位元組或費用欄位。

OpenAPI schema · OpenAI 生成參考文件 · OpenAI 編輯參考文件 · OpenAI 影像指南

On this page