概述
此端點保留給舊版 OpenAI 相容的變體客戶端。它不是目前 image-to-image 工作流的推薦路徑;可使用新流程時,請使用/v1/images/edits + gpt-image-2,或在 /v1/images/generations 中使用 nano-banana-pro 等 image-to-image 模型。請求必須使用 multipart/form-data。
請求主體
同步請求逾時: 某些路由到的圖片提供者會以内嵌方式返回最終圖片,並等待生成完成。高解析度或高品質請求可能接近一分鐘甚至更久,因此請將 HTTP 用戶端逾時設定為至少120s。如果建立回應包含 status: "pending"、task_id 或 poll_url,請改為依照返回的 poll_url 輪詢。
file
必填
用作變體基礎的圖像。必須是有效的 PNG 檔案,小於 50MB,且為正方形。
string
必填
舊版變體相容路由的必填模型 ID。沒有隱含預設模型;目前 image-to-image 工作流請優先使用
/v1/images/edits 或 /v1/images/generations 搭配目前模型。integer
預設值:"1"
要生成的圖像數量。必須在 1 到 10 之間。
string
舊版變體相容路由生成圖片的尺寸。支援的取值取決於所選模型。
string
預設值:"url"
回傳生成圖像的格式。必須是
url 或 b64_json。string
代表終端使用者的唯一識別碼,用於濫用監控。
回應
integer
圖像建立時間的 Unix 時間戳。
array
生成的圖像變體陣列。每個物件包含:
url(string): 變體圖像的 URL(如果 response_format 是url)b64_json(string): Base64 編碼的圖像(如果 response_format 是b64_json)
注意事項
這是舊版相容端點,不在目前推薦圖片模型目錄中。新接入請使用
/v1/images/edits + gpt-image-2,或在 /v1/images/generations 中設定 operation: "image-to-image" 並選擇目前 image-to-image 模型。