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.completeddata: [DONE] 後結束。

支援欄位為 modelpromptn=1quality=medium|high、合法 WIDTHxHEIGHTresponse_format=url|b64_jsonoutput_format=png 與可選 stream。圖片編輯、變體、參考圖、局部圖及未知欄位會被拒絕;失敗請求的預扣 Credits 會透過依 Request ID 冪等的退款路徑返還。

請使用一般 API Key。綁定特定渠道的 Key 會被拒絕;啟用模型限制的 Key 必須包含 gpt-image-2