建立圖片變體

可依模型功能控制變體數量、尺寸與回傳格式。

POST/v1/images/variations

根據一張輸入圖片生成一個或多個視覺變體。輸入圖片必須符合所選模型支援的格式、大小和尺寸要求。

模型是否支援圖片變體，以目前 API Key 可見模型的實際能力為準。

授權

bearerAuth

授權Bearer <token>

在 Authorization Header 中使用 Bearer your-api-key。

傳遞位置: header

請求主體

multipart/form-data

使用 Multipart 提交變體來源圖片。用戶端應由請求庫自動產生 Content-Type 的 boundary。

TypeScript 型別定義

在 TypeScript 中使用 request body 型別。

image*file

作為變體基礎的圖片。請使用小於 4 MB 的正方形 PNG；實際檔案限制以所選模型為準。

格式binary

model?string

要使用的圖片變體模型 ID。請選擇目前 API Key 可見且支援圖片變體的模型。

長度1 <= length

n?integer|null

要回傳的圖片變體數量，取值範圍為 1 到 10，實際支援數量取決於所選模型。

範圍1 <= value <= 10

預設值1

response_format?string|null

圖片回傳格式。url 回傳圖片網址，此網址在生成後 60 分鐘內有效；b64_json 回傳 Base64 編碼圖片資料。

預設值"url"

可用值

"url"
"b64_json"
null

size?string|null

圖片尺寸，支援 256x256、512x512 和 1024x1024。

預設值"1024x1024"

可用值

"256x256"
"512x512"
"1024x1024"
null

user?string

代表終端使用者的唯一識別碼，可用於監控和偵測濫用行為。

長度1 <= length

回應主體

`application/json`

curl -X POST "https://example.com/v1/images/variations" \  -F image="otter.png" \  -F model="MODEL_ID" \  -F n="2" \  -F size="1024x1024"

{
  "created": 1589478378,
  "data": [
    {
      "url": "https://example.com/image-variation-1.png"
    },
    {
      "url": "https://example.com/image-variation-2.png"
    }
  ]
}

授權

請求主體

回應主體

200application/json

401application/json

`application/json`

`application/json`