影像生成與編輯

透過 OpenAI 相容的影像端點生成和編輯影像,支援多部分上傳與 JSON 影像 URL 輸入。

總覽

使用標準 OpenAI 影像路由生成全新影像或編輯既有影像,原生支援檔案上傳及針對 gpt-image-2 的非串流 JSON 影像 URL 輸入。

影像生成

POST/v1/images/generations
  • 規範端點:POST /v1/images/generations(operationId: openai.images.generations)接收提示詞並生成全新圖像。
  • 生成參數:接收 prompt 以及選填的 model、n、quality 與 size。
  • 相容別名:相容接收 POST /openai/v1/images/generations(operationId: openai.images.generations.alias)。

影像編輯

POST/openai/v1/images/edits
json
{
  "model": "gpt-image-2",
  "prompt": "將這些參考圖像融合為一幅超現實主義風格的藝術肖像。",
  "images": [
    { "image_url": "https://cdn.example.com/reference-1.png" },
    { "image_url": "https://cdn.example.com/reference-2.png" }
  ],
  "mask": {
    "image_url": "https://cdn.example.com/mask.png"
  },
  "n": 1,
  "quality": "medium",
  "size": "1024x1024"
}
  • 規範端點:POST /openai/v1/images/edits(operationId: openai.images.edits),同時提供相容別名 POST /v1/images/edits(operationId: openai.images.edits.alias)。
  • JSON URL 輸入:針對 gpt-image-2 及支援的原生通道,發送非串流 JSON,包含 model、prompt、含 1 至 16 個 image_url 物件的 images 陣列以及選填 mask 物件(image_url)。
  • 公開 HTTPS 規範:影像 URL 必須為可直接公開存取的 HTTPS 位址且不含內嵌鑑權憑證,由上游直接讀取。
  • 品質與尺寸控制:gpt-image-2 預設 quality 為 medium(同時支援 low 與 high);其他原生參數透傳至底層。
  • 操作協定:基於 operationId: openai.images.edits 發布,並相容支援 POST /v1/images/edits 別名。