GPT Image 2 圖片生成 API
透過同步 JSON 或具心跳的 SSE 呼叫 GPT Image 2,並取得短期簽名圖片 URL 或 base64。
透過 OpenAI 相容 Images API 使用 gpt-image-2 生成 PNG。第一階段每次只生成一張,支援中等或高畫質、短期簽名 URL 或 base64,以及可選 SSE。
選擇入口與模式
- 可能耗時數分鐘的同步 JSON 請求使用 https://origin.modelflare.dev/v1。
- 經 Cloudflare 的長請求使用 https://modelflare.dev/v1 並設定 stream=true;最終圖片完成前會持續傳送 SSE 心跳。
- 不要在請求進行中跨網域重新導向 POST;提交前先選定 Base URL。
同步請求
curl https://origin.modelflare.dev/v1/images/generations \
-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-image-2","prompt":"黎明時寧靜的湖畔木屋,電影感自然光","n":1,"quality":"medium","size":"1024x1024","response_format":"url","output_format":"png"}'
URL 回應包含一小時後到期的 Modelflare 私有簽名連結。將 response_format 設為 b64_json,可直接取得驗證後的 PNG 而不儲存 API 輸出物件。
即時模型與價格頁面會列出常用尺寸的 medium 與 high 價格點;實際扣費依請求的畫質與尺寸計算,不疊加一般路由群組倍率,最終費用會記錄於用量日誌。
串流請求
curl -N https://modelflare.dev/v1/images/generations \
-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-image-2","prompt":"一隻白貓在雨中的霓虹街道奔跑","n":1,"quality":"high","size":"1024x1024","response_format":"url","stream":true}'
SSE 註解只是心跳。收到 image_generation.completed 與 data: [DONE] 後結束。
支援欄位為 model、prompt、n=1、quality=medium|high、合法 WIDTHxHEIGHT、response_format=url|b64_json、output_format=png 與可選 stream。圖片編輯、變體、參考圖、局部圖及未知欄位會被拒絕;失敗請求的預扣 Credits 會透過依 Request ID 冪等的退款路徑返還。
請使用一般 API Key。綁定特定渠道的 Key 會被拒絕;啟用模型限制的 Key 必須包含 gpt-image-2。