OpenAI Image API 兼容接口

本平臺對外提供兼容 OpenAI Image API 的圖片接口，當前推薦模型為 gpt-image-2。

截至 2026-04-28，OpenAI 官方模型頁將 gpt-image-2 標記為預設的旗艦圖片生成模型。在 ReachAPI 上，請求體與響應結構保持與 OpenAI 原生接口一致，集成時主要只需要替換基礎域名。

如果需要任務查詢、終態回調，或從 data[].url 獲取最終圖片地址，請使用 GPT Image 2 異步圖片接口，並傳入 model: "gpt-image-2-async"。

接口映射

能力	OpenAI 原生地址	ReachAPI 地址
圖片生成	`https://api.openai.com/v1/images/generations`	`https://direct.reachapi.ai/v1/images/generations`
圖片編輯	`https://api.openai.com/v1/images/edits`	`https://direct.reachapi.ai/v1/images/edits`

認證方式

使用 ReachAPI Key：

Authorization: Bearer YOUR_REACH_API_KEY

圖片生成請求使用：

Content-Type: application/json

圖片編輯請求沿用 OpenAI 原生 multipart/form-data，使用 curl -F 或 SDK/FormData 即可，不需要手動寫死 Content-Type 邊界。

兼容性說明

推薦模型：gpt-image-2
請求字段和響應對象遵循 OpenAI 官方 Image API 文檔
POST /v1/images/edits 使用 OpenAI 原生圖片編輯請求格式，Content-Type 為 multipart/form-data
編輯請求字段沿用官方命名，例如 image、mask、prompt、model
官方 gpt-image-2 模型頁當前標注支持圖片生成與圖片編輯，並注明不支持流式返回

最小示例

圖片生成

curl -X POST "https://direct.reachapi.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_REACH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一張鈷藍色機械鍵盤的編輯風格產品圖，放在石板灰桌面上"
  }'

圖片編輯

curl -X POST "https://direct.reachapi.ai/v1/images/edits" \
  -H "Authorization: Bearer YOUR_REACH_API_KEY" \
  -F "model=gpt-image-2" \
  -F "prompt=將背景替換為乾淨的攝影棚背景，並優化整體布光" \
  -F "image=@/path/to/source.png"

官方文檔

模型說明：GPT Image 2
使用指南：Image generation
接口參考：Create image
接口參考：Create image edit

像 background、moderation、output_format、output_compression、size、quality、mask、input_fidelity 等具體參數，以及完整響應字段，請以以上 OpenAI 官方文檔為準；其中編輯接口請按官方原生 multipart/form-data 寫法調用。