GPT Image 2.5 Flare 是 OpenAI 定位於快速、高品質日常工作的圖片生成與編輯版本。它接受文字與圖片，傳回圖片結果。適合視覺草稿、插畫、產品概念，以及需要儘快將需求轉成可用圖片的例行創意任務。Flare 與強調編輯精確度的 Sunburst 不同。日常圖片創作可選 Flare，精確編輯優先時則選 Sunburst。
先描述主要主體、動作、環境、構圖與視覺處理。行銷插畫可要求騎士在溫暖傍晚光線中騎車越過小橋，具有鮮明輪廓，天空留白供後續加字。簡短探索需求可開放美感決策；製作需求則應指出重要細節與位置。直接生成與編輯流程允許最多 32,000 個字元的提示詞與 1 至 10 個結果，方便依相同目的比較數個變化版本。
編輯最多可提供 16 張參考圖片。為每張參考圖分配清楚角色，不要期待模型自行判斷圖片代表主體識別、風景或風格。遮罩可引導區域變更；有多張圖片時，作用於第一張。圖片與遮罩須格式及尺寸相符，遮罩須含 alpha 通道。指南要求來源與遮罩小於 50 MB。遮罩是引導，不承諾精確保留邊界，因此應同時說明所需修改與應保持辨識度的內容。
Flare 支援 low、medium、high、xhigh、max 與自動品質，預設 auto。較低品質可用於快速視覺草稿，較高設定可供比較最終素材細節。品質與尺寸、輸出壓縮各自獨立。標準尺寸包括 1024 × 1024、1536 × 1024 與 1024 × 1536，也可使用自動或自訂尺寸。請依最終位置與場景可用空間選擇方向。
自訂寬高須為 16 的倍數，任一邊不得超過 3840 像素。允許比例介於 1:3 至 3:1，總面積至少 655,360、最多 8,294,400 像素。四項條件須同時滿足。指南將高於 2560 × 1440 的解析度列為實驗性。請使用符合構圖的有效畫面，並在需求中納入容易受裁切影響的細節，不要將較高解析度當作版面自動改善。
結果預設為 PNG，也可選 JPEG 或 WebP。JPEG 與 WebP 允許 0 至 100 的壓縮設定。透明背景請選 PNG 或 WebP；也支援不透明與自動背景。透明素材可放入後續版面，不透明圖片則包含自己的背景。依實際交付需求選擇格式、背景與壓縮，並將完成檔案與需求及選定設定一併保存。
原廠記載直接圖片生成與編輯，以及能保留選定結果供後續修改的對話式圖片工具。此流程的上下文有圖片時，action 可為自動、強制生成或強制編輯。串流可在最終結果前顯示最多 3 張部分圖片。這些預覽呈現進度，不是額外完成成果。反覆編輯時，從選定圖片繼續，描述可見變更，例如移動一個物件或調整色彩處理。原廠介面也支援批次處理。
以預定尺寸檢查圖片文字、物件位置、主體細節與構圖。GPT Image 在精確文字位置、結構化版面，以及多次生成間維持視覺識別上，仍可能有困難。保留已接受版本作為下一次參考，並將後續編輯限縮到重要問題。Flare 的日常生成定位，適合需求、視覺方案、選擇與精修的清楚流程；最終素材則應依實際創作用途評估。
", "aboutText": "GPT Image 2.5 Flare 是 OpenAI 定位於快速、高品質日常工作的圖片生成與編輯版本。它接受文字與圖片，傳回圖片結果。適合視覺草稿、插畫、產品概念，以及需要儘快將需求轉成可用圖片的例行創意任務。Flare 與強調編輯精確度的 Sunburst 不同。日常圖片創作可選 Flare，精確編輯優先時則選 Sunburst。\n\n先描述主要主體、動作、環境、構圖與視覺處理。行銷插畫可要求騎士在溫暖傍晚光線中騎車越過小橋，具有鮮明輪廓，天空留白供後續加字。簡短探索需求可開放美感決策；製作需求則應指出重要細節與位置。直接生成與編輯流程允許最多 32,000 個字元的提示詞與 1 至 10 個結果，方便依相同目的比較數個變化版本。\n\n編輯最多可提供 16 張參考圖片。為每張參考圖分配清楚角色，不要期待模型自行判斷圖片代表主體識別、風景或風格。遮罩可引導區域變更；有多張圖片時，作用於第一張。圖片與遮罩須格式及尺寸相符，遮罩須含 alpha 通道。指南要求來源與遮罩小於 50 MB。遮罩是引導，不承諾精確保留邊界，因此應同時說明所需修改與應保持辨識度的內容。\n\nFlare 支援 low、medium、high、xhigh、max 與自動品質，預設 auto。較低品質可用於快速視覺草稿，較高設定可供比較最終素材細節。品質與尺寸、輸出壓縮各自獨立。標準尺寸包括 1024 × 1024、1536 × 1024 與 1024 × 1536，也可使用自動或自訂尺寸。請依最終位置與場景可用空間選擇方向。\n\n自訂寬高須為 16 的倍數，任一邊不得超過 3840 像素。允許比例介於 1:3 至 3:1，總面積至少 655,360、最多 8,294,400 像素。四項條件須同時滿足。指南將高於 2560 × 1440 的解析度列為實驗性。請使用符合構圖的有效畫面，並在需求中納入容易受裁切影響的細節，不要將較高解析度當作版面自動改善。\n\n結果預設為 PNG，也可選 JPEG 或 WebP。JPEG 與 WebP 允許 0 至 100 的壓縮設定。透明背景請選 PNG 或 WebP；也支援不透明與自動背景。透明素材可放入後續版面，不透明圖片則包含自己的背景。依實際交付需求選擇格式、背景與壓縮，並將完成檔案與需求及選定設定一併保存。\n\n原廠記載直接圖片生成與編輯，以及能保留選定結果供後續修改的對話式圖片工具。此流程的上下文有圖片時，action 可為自動、強制生成或強制編輯。串流可在最終結果前顯示最多 3 張部分圖片。這些預覽呈現進度，不是額外完成成果。反覆編輯時，從選定圖片繼續，描述可見變更，例如移動一個物件或調整色彩處理。原廠介面也支援批次處理。\n\n以預定尺寸檢查圖片文字、物件位置、主體細節與構圖。GPT Image 在精確文字位置、結構化版面，以及多次生成間維持視覺識別上，仍可能有困難。保留已接受版本作為下一次參考，並將後續編輯限縮到重要問題。Flare 的日常生成定位，適合需求、視覺方案、選擇與精修的清楚流程；最終素材則應依實際創作用途評估。", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "803aefd1087ccf7f9eef40ead5daa09256136e1c3ac1a0b3c11de59d61e0f40d", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "zh-hant-tw", "methods": [ { "html": "gpt-image-2.5-flareGPT Image 2.5 Flare 可依文字與參考圖生成及編輯圖片，著重快速的日常視覺創作。它支援自訂尺寸、透明背景、遮罩，以及最高 max 的品質級別，適合草稿、插畫與行銷活動素材。
此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。
GPT Image 2.5 Flare 是 OpenAI 定位於快速、高品質日常工作的圖片生成與編輯版本。它接受文字與圖片，傳回圖片結果。適合視覺草稿、插畫、產品概念，以及需要儘快將需求轉成可用圖片的例行創意任務。Flare 與強調編輯精確度的 Sunburst 不同。日常圖片創作可選 Flare，精確編輯優先時則選 Sunburst。
先描述主要主體、動作、環境、構圖與視覺處理。行銷插畫可要求騎士在溫暖傍晚光線中騎車越過小橋，具有鮮明輪廓，天空留白供後續加字。簡短探索需求可開放美感決策；製作需求則應指出重要細節與位置。直接生成與編輯流程允許最多 32,000 個字元的提示詞與 1 至 10 個結果，方便依相同目的比較數個變化版本。
編輯最多可提供 16 張參考圖片。為每張參考圖分配清楚角色，不要期待模型自行判斷圖片代表主體識別、風景或風格。遮罩可引導區域變更；有多張圖片時，作用於第一張。圖片與遮罩須格式及尺寸相符，遮罩須含 alpha 通道。指南要求來源與遮罩小於 50 MB。遮罩是引導，不承諾精確保留邊界，因此應同時說明所需修改與應保持辨識度的內容。
Flare 支援 low、medium、high、xhigh、max 與自動品質，預設 auto。較低品質可用於快速視覺草稿，較高設定可供比較最終素材細節。品質與尺寸、輸出壓縮各自獨立。標準尺寸包括 1024 × 1024、1536 × 1024 與 1024 × 1536，也可使用自動或自訂尺寸。請依最終位置與場景可用空間選擇方向。
自訂寬高須為 16 的倍數，任一邊不得超過 3840 像素。允許比例介於 1:3 至 3:1，總面積至少 655,360、最多 8,294,400 像素。四項條件須同時滿足。指南將高於 2560 × 1440 的解析度列為實驗性。請使用符合構圖的有效畫面，並在需求中納入容易受裁切影響的細節，不要將較高解析度當作版面自動改善。
結果預設為 PNG，也可選 JPEG 或 WebP。JPEG 與 WebP 允許 0 至 100 的壓縮設定。透明背景請選 PNG 或 WebP；也支援不透明與自動背景。透明素材可放入後續版面，不透明圖片則包含自己的背景。依實際交付需求選擇格式、背景與壓縮，並將完成檔案與需求及選定設定一併保存。
原廠記載直接圖片生成與編輯，以及能保留選定結果供後續修改的對話式圖片工具。此流程的上下文有圖片時，action 可為自動、強制生成或強制編輯。串流可在最終結果前顯示最多 3 張部分圖片。這些預覽呈現進度，不是額外完成成果。反覆編輯時，從選定圖片繼續，描述可見變更，例如移動一個物件或調整色彩處理。原廠介面也支援批次處理。
以預定尺寸檢查圖片文字、物件位置、主體細節與構圖。GPT Image 在精確文字位置、結構化版面，以及多次生成間維持視覺識別上，仍可能有困難。保留已接受版本作為下一次參考，並將後續編輯限縮到重要問題。Flare 的日常生成定位，適合需求、視覺方案、選擇與精修的清楚流程；最終素材則應依實際創作用途評估。
POST /v1/images/generationstextimage| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位model | 類型string | 要求必填 | 值與限制 gpt-image-2.5-flare | 預設值— |
欄位prompt | 類型string | 要求必填 | 值與限制 長度下限: 1 | 預設值— |
欄位n | 類型integer | 要求選填 | 值與限制 最小值: 1 | 預設值1 |
欄位response_format | 類型string | 要求選填 | 值與限制 url, b64_json | 預設值— |
欄位stream | 類型boolean | 要求選填 | 值與限制 | 預設值false |
欄位size | 類型string | 要求選填 | 值與限制 依模型而定 | 預設值— |
欄位quality | 類型string | 要求選填 | 值與限制 依模型而定 | 預設值— |
欄位background | 類型string | 要求選填 | 值與限制 依模型而定 | 預設值— |
欄位output_format | 類型string | 要求選填 | 值與限制 依模型而定 | 預設值— |
欄位output_compression | 類型integer | 要求選填 | 值與限制 依模型而定 | 預設值— |
欄位moderation | 類型string | 要求選填 | 值與限制 依模型而定 | 預設值— |
欄位input_fidelity | 類型string | 要求選填 | 值與限制 依模型而定 | 預設值— |
欄位style | 類型string | 要求選填 | 值與限制 依模型而定 | 預設值— |
欄位partial_images | 類型integer | 要求選填 | 值與限制 依模型而定 | 預設值— |
文字生成圖片 · 必填： prompt
| 參數 | 規格 |
|---|---|
參數material_types | 規格text |
參數required | 規格model, prompt |
參數optional_controls | 規格null |
參數content_type | 規格application/json |
生命週期： synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · 實際回傳的 task_id 或媒體庫紀錄
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
方法結構與 ID 均為精確值；供應商能力與准入狀態分開。
POST /v1/images/generationsAiloot 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "gpt-image-2.5-flare", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nfrom openai import OpenAI\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\n\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'gpt-image-2.5-flare', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "gpt-image-2.5-flare", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\n下載每張傳回的圖片，或儲存其 Base64 內容
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}請儲存每張已完成的圖片；從每個傳回的 URL 取得圖片，或解碼其 Base64 內容。
儲存所有資料項目。解碼每個 b64_json，或透過每個回傳的已簽署 URL 取得內容。依實際 MIME 類型／位元組內容選擇副檔名。
若圖片生成或編輯結果需要檢查，請保留原始 operation_id/X-Client-Request-ID 與回傳的結果資訊。使用實際的 task_id 或 asset_id 值，透過媒體庫取回自己擁有的既有結果。請勿重新提交生成／編輯請求，也請勿以 operation_id 組成輪詢 URL。
| 欄位 | 類型 |
|---|---|
欄位created | 類型integer |
欄位data[].url | 類型string |
欄位data[].b64_json | 類型base64 string |
欄位usage | 類型object |
| 回應 | 條件 | 下一步 |
|---|---|---|
回應400 · invalid_request_error | 條件必要欄位、素材表示方式或參數值無效 | 下一步提出新的建立請求前，先修正指定欄位。 |
回應server_error | 條件回傳的回應表示該作業或結果需要檢查 | 下一步保留原始回傳的作業／任務 ID、請求標頭與回應；繼續以支援的方式讀取該原始作業。請勿重新提交建立請求。 |
Ailoot gpt-image-2.5-flare
Ailoot Ultra gpt-image-2.5-flare, openai/gpt-image-2.5-flare
/v1/images
openai/gpt-image-2.5-flare, gpt-image-2.5-flare, gpt-image-2.5-flare
gpt-image-2.5-flareGPT Image 2.5 Flare 可依文字與參考圖生成及編輯圖片，著重快速的日常視覺創作。它支援自訂尺寸、透明背景、遮罩，以及最高 max 的品質級別，適合草稿、插畫與行銷活動素材。
此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。
GPT Image 2.5 Flare 是 OpenAI 定位於快速、高品質日常工作的圖片生成與編輯版本。它接受文字與圖片，傳回圖片結果。適合視覺草稿、插畫、產品概念，以及需要儘快將需求轉成可用圖片的例行創意任務。Flare 與強調編輯精確度的 Sunburst 不同。日常圖片創作可選 Flare，精確編輯優先時則選 Sunburst。
先描述主要主體、動作、環境、構圖與視覺處理。行銷插畫可要求騎士在溫暖傍晚光線中騎車越過小橋，具有鮮明輪廓，天空留白供後續加字。簡短探索需求可開放美感決策；製作需求則應指出重要細節與位置。直接生成與編輯流程允許最多 32,000 個字元的提示詞與 1 至 10 個結果，方便依相同目的比較數個變化版本。
編輯最多可提供 16 張參考圖片。為每張參考圖分配清楚角色，不要期待模型自行判斷圖片代表主體識別、風景或風格。遮罩可引導區域變更；有多張圖片時，作用於第一張。圖片與遮罩須格式及尺寸相符，遮罩須含 alpha 通道。指南要求來源與遮罩小於 50 MB。遮罩是引導，不承諾精確保留邊界，因此應同時說明所需修改與應保持辨識度的內容。
Flare 支援 low、medium、high、xhigh、max 與自動品質，預設 auto。較低品質可用於快速視覺草稿，較高設定可供比較最終素材細節。品質與尺寸、輸出壓縮各自獨立。標準尺寸包括 1024 × 1024、1536 × 1024 與 1024 × 1536，也可使用自動或自訂尺寸。請依最終位置與場景可用空間選擇方向。
自訂寬高須為 16 的倍數，任一邊不得超過 3840 像素。允許比例介於 1:3 至 3:1，總面積至少 655,360、最多 8,294,400 像素。四項條件須同時滿足。指南將高於 2560 × 1440 的解析度列為實驗性。請使用符合構圖的有效畫面，並在需求中納入容易受裁切影響的細節，不要將較高解析度當作版面自動改善。
結果預設為 PNG，也可選 JPEG 或 WebP。JPEG 與 WebP 允許 0 至 100 的壓縮設定。透明背景請選 PNG 或 WebP；也支援不透明與自動背景。透明素材可放入後續版面，不透明圖片則包含自己的背景。依實際交付需求選擇格式、背景與壓縮，並將完成檔案與需求及選定設定一併保存。
原廠記載直接圖片生成與編輯，以及能保留選定結果供後續修改的對話式圖片工具。此流程的上下文有圖片時，action 可為自動、強制生成或強制編輯。串流可在最終結果前顯示最多 3 張部分圖片。這些預覽呈現進度，不是額外完成成果。反覆編輯時，從選定圖片繼續，描述可見變更，例如移動一個物件或調整色彩處理。原廠介面也支援批次處理。
以預定尺寸檢查圖片文字、物件位置、主體細節與構圖。GPT Image 在精確文字位置、結構化版面，以及多次生成間維持視覺識別上，仍可能有困難。保留已接受版本作為下一次參考，並將後續編輯限縮到重要問題。Flare 的日常生成定位，適合需求、視覺方案、選擇與精修的清楚流程；最終素材則應依實際創作用途評估。
POST /v1/images/generationstextimage| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位model | 類型string | 要求必填 | 值與限制 gpt-image-2.5-flare | 預設值— |
欄位prompt | 類型string | 要求必填 | 值與限制 長度上限: 32,000 | 預設值— |
欄位size | 類型string | 要求選填 | 值與限制 條件: 請使用 auto 或 WIDTHxHEIGHT，且兩個尺寸均須可被 16 整除。最長邊不得超過 3,840 像素，總像素數不得超過 8,300,000。 | 預設值auto |
欄位background | 類型string | 要求選填 | 值與限制 transparent, opaque, auto | 預設值auto |
欄位moderation | 類型string | 要求選填 | 值與限制 low, auto 條件: 標準內容審核請使用 auto。 | 預設值— |
欄位n | 類型integer | 要求選填 | 值與限制 最小值: 1 最大值: 10 | 預設值1 |
欄位quality | 類型string | 要求選填 | 值與限制 auto, high, medium, low | 預設值auto |
欄位output_compression | 類型integer | 要求選填 | 值與限制 最小值: 0 最大值: 100 條件: 適用於 JPEG 與 WebP 輸出；請傳送文件記載的整數值。 | 預設值100 |
欄位output_format | 類型string | 要求選填 | 值與限制 webp, png, jpeg | 預設值png |
欄位stream | 類型boolean | 要求選填 | 值與限制 false 條件: 此路由會回傳一份已完成的 JSON 回應。 | 預設值false |
| 參數 | 規格 |
|---|---|
參數content_type | 規格application/json |
參數required | 規格prompt, model |
參數material_types | 規格text |
參數optional | 規格size, background, moderation, n, quality, output_compression, output_format, stream |
參數conditions | 規格透明背景必須使用 PNG 或 WebP。, 輸出壓縮適用於 JPEG 或 WebP。, 所選方法會依文字生成。製造商說明的編輯與串流控制屬於獨立能力。 |
生命週期： synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · 實際回傳的 task_id 或媒體庫紀錄
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
顯示的費率用於在生成前估算費用。最終費用依原始生成作業記錄的成本計算。實測的輸出時間長度與預估數量並非最終計費數量。
費率資訊不會增加請求選項。支援的參數列於所選方法中。
請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。
| 設定 | 費率表 | 預估數量 | 費用 |
|---|---|---|---|
| 設定基礎 token 費率 | 費率表基本費率 | 預估數量— | 費用 輸入 · 輸入 Token · 僅供比較的估算 — / 1K Token 輸出 · 輸出 Token · 僅供比較的估算 — / 1K Token 輸入 · 讀取快取 · 僅供比較的估算 — / 1K Token 輸入 · 寫入快取 · 僅供比較的估算 — / 1K Token 輸入 · 寫入快取，1 小時 · 僅供比較的估算 — / 1K Token |
| 設定預估生成費用 | 費率表— | 預估數量單次生成估算值 | 費用 輸出 · 預估生成費用 · 僅供比較的估算 $0.24576 生成前估算 此估算並非額外費用，也不是本次生成完成後的固定費率。 |
Ailoot 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'prompt': 'A cute baby sea otter', 'model': 'gpt-image-2.5-flare', 'size': '1024x1024', 'n': 1, 'background': 'auto', 'moderation': 'auto', 'output_format': 'png'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\n下載每張傳回的圖片，或儲存其 Base64 內容
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\n請儲存每張已完成的圖片；從每個傳回的 URL 取得圖片，或解碼其 Base64 內容。
保留完整回應與標頭、所有實際輸出、原始回傳的識別碼，以及所有用量欄位。恢復原始作業時，請勿再次提交建立請求。
保留回傳的 X-Client-Request-ID，以供核對。僅讀取實際回傳的 task_id/asset_id 值或自己擁有的媒體庫；請勿以作業 ID 組成任務 URL，也請勿重新提交建立請求。
| 欄位 | 類型 |
|---|---|
欄位created | 類型 |
欄位data[].url | 類型 |
欄位data[].b64_json | 類型 |
欄位usage | 類型 |
Ailoot gpt-image-2.5-flare
Ailoot Ultra gpt-image-2.5-flare, openai/gpt-image-2.5-flare
/v1/images
openai/gpt-image-2.5-flare, gpt-image-2.5-flare, gpt-image-2.5-flare
openai/gpt-image-2.5-flareGPT Image 2.5 Flare 可依文字與參考圖生成及編輯圖片，著重快速的日常視覺創作。它支援自訂尺寸、透明背景、遮罩，以及最高 max 的品質級別，適合草稿、插畫與行銷活動素材。
此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。
GPT Image 2.5 Flare 是 OpenAI 定位於快速、高品質日常工作的圖片生成與編輯版本。它接受文字與圖片，傳回圖片結果。適合視覺草稿、插畫、產品概念，以及需要儘快將需求轉成可用圖片的例行創意任務。Flare 與強調編輯精確度的 Sunburst 不同。日常圖片創作可選 Flare，精確編輯優先時則選 Sunburst。
先描述主要主體、動作、環境、構圖與視覺處理。行銷插畫可要求騎士在溫暖傍晚光線中騎車越過小橋，具有鮮明輪廓，天空留白供後續加字。簡短探索需求可開放美感決策；製作需求則應指出重要細節與位置。直接生成與編輯流程允許最多 32,000 個字元的提示詞與 1 至 10 個結果，方便依相同目的比較數個變化版本。
編輯最多可提供 16 張參考圖片。為每張參考圖分配清楚角色，不要期待模型自行判斷圖片代表主體識別、風景或風格。遮罩可引導區域變更；有多張圖片時，作用於第一張。圖片與遮罩須格式及尺寸相符，遮罩須含 alpha 通道。指南要求來源與遮罩小於 50 MB。遮罩是引導，不承諾精確保留邊界，因此應同時說明所需修改與應保持辨識度的內容。
Flare 支援 low、medium、high、xhigh、max 與自動品質，預設 auto。較低品質可用於快速視覺草稿，較高設定可供比較最終素材細節。品質與尺寸、輸出壓縮各自獨立。標準尺寸包括 1024 × 1024、1536 × 1024 與 1024 × 1536，也可使用自動或自訂尺寸。請依最終位置與場景可用空間選擇方向。
自訂寬高須為 16 的倍數，任一邊不得超過 3840 像素。允許比例介於 1:3 至 3:1，總面積至少 655,360、最多 8,294,400 像素。四項條件須同時滿足。指南將高於 2560 × 1440 的解析度列為實驗性。請使用符合構圖的有效畫面，並在需求中納入容易受裁切影響的細節，不要將較高解析度當作版面自動改善。
結果預設為 PNG，也可選 JPEG 或 WebP。JPEG 與 WebP 允許 0 至 100 的壓縮設定。透明背景請選 PNG 或 WebP；也支援不透明與自動背景。透明素材可放入後續版面，不透明圖片則包含自己的背景。依實際交付需求選擇格式、背景與壓縮，並將完成檔案與需求及選定設定一併保存。
原廠記載直接圖片生成與編輯，以及能保留選定結果供後續修改的對話式圖片工具。此流程的上下文有圖片時，action 可為自動、強制生成或強制編輯。串流可在最終結果前顯示最多 3 張部分圖片。這些預覽呈現進度，不是額外完成成果。反覆編輯時，從選定圖片繼續，描述可見變更，例如移動一個物件或調整色彩處理。原廠介面也支援批次處理。
以預定尺寸檢查圖片文字、物件位置、主體細節與構圖。GPT Image 在精確文字位置、結構化版面，以及多次生成間維持視覺識別上，仍可能有困難。保留已接受版本作為下一次參考，並將後續編輯限縮到重要問題。Flare 的日常生成定位，適合需求、視覺方案、選擇與精修的清楚流程；最終素材則應依實際創作用途評估。
POST /v1/images/generationstext, imageimage| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位model | 類型string | 要求必填 | 值與限制 openai/gpt-image-2.5-flare | 預設值— |
欄位prompt | 類型string | 要求必填 | 值與限制 長度下限: 1 | 預設值— |
欄位aspect_ratio | 類型string | 要求選填 | 值與限制 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9, auto | 預設值— |
欄位quality | 類型string | 要求選填 | 值與限制 auto, low, medium, high, xhigh, max | 預設值— |
欄位background | 類型string | 要求選填 | 值與限制 auto, transparent, opaque | 預設值— |
欄位n | 類型integer | 要求選填 | 值與限制 最小值: 1 最大值: 10 | 預設值— |
欄位input_references | 類型array | 要求選填 | 值與限制 項目數下限: 0 項目數上限: 16 | 預設值— |
欄位output_compression | 類型integer | 要求選填 | 值與限制 最小值: 0 最大值: 100 | 預設值— |
欄位provider | 類型object | 要求選填 | 值與限制 | 預設值— |
| 參數 | 規格 |
|---|---|
參數content_type | 規格application/json |
參數required | 規格model, prompt |
參數material_types | 規格text, image |
生命週期： synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · 實際回傳的 task_id 或媒體庫紀錄
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
顯示的費率用於在生成前估算費用。最終費用依原始生成作業記錄的成本計算。實測的輸出時間長度與預估數量並非最終計費數量。
費率資訊不會增加請求選項。支援的參數列於所選方法中。
請逐一核對各項費用與所列條件。每組互為替代選項的設定只套用一種費率。
| 設定 | 費率表 | 預估數量 | 費用 |
|---|---|---|---|
| 設定基礎 token 費率 | 費率表基本費率 | 預估數量— | 費用 輸入 · 輸入 Token · 僅供比較的估算 — / 1K Token 輸出 · 輸出 Token · 僅供比較的估算 — / 1K Token 輸入 · 讀取快取 · 僅供比較的估算 — / 1K Token 輸入 · 寫入快取 · 僅供比較的估算 — / 1K Token 輸入 · 寫入快取，1 小時 · 僅供比較的估算 — / 1K Token |
| 設定預估生成費用 | 費率表— | 預估數量單次生成估算值 | 費用 輸出 · 預估生成費用 · 僅供比較的估算 $0.24576 生成前估算 此估算並非額外費用，也不是本次生成完成後的固定費率。 |
Ailoot 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'openai/gpt-image-2.5-flare', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\n下載每張傳回的圖片，或儲存其 Base64 內容
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\n請儲存每張已完成的圖片；從每個傳回的 URL 取得圖片，或解碼其 Base64 內容。
保留完整回應與標頭、所有實際輸出、原始回傳的識別碼，以及所有用量欄位。恢復原始作業時，請勿再次提交建立請求。
保留回傳的 X-Client-Request-ID，以供核對。僅讀取實際回傳的 task_id/asset_id 值或自己擁有的媒體庫；請勿以作業 ID 組成任務 URL，也請勿重新提交建立請求。
| 欄位 | 類型 |
|---|---|
欄位created | 類型 |
欄位data[].url | 類型 |
欄位data[].b64_json | 類型 |
欄位usage | 類型 |
Ailoot gpt-image-2.5-flare
Ailoot Ultra gpt-image-2.5-flare, openai/gpt-image-2.5-flare
/v1/images
openai/gpt-image-2.5-flare, gpt-image-2.5-flare, gpt-image-2.5-flare