影像生成與編輯
透過 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{
"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別名。