TokenLab

圖像

建立圖片變化

建立指定圖片的變化版本

POST
/v1/images/variations

概覽

此端點支援現有的 OpenAI Variations 用戶端。若要使用新的圖生圖功能,請將 /v1/images/edits 或 /v1/images/generations 搭配目前的圖生圖模型使用。請求使用 multipart/form-data。

請求主體

此端點為同步處理:回應會直接包含最終圖片,而非任務狀態。請將您的 HTTP 用戶端逾時時間設定為至少 120s。

imagefile必填

Multipart 來源圖片。檔案與完整的請求主體大小皆不可超過 50 MiB(超過限制之上傳將傳回 413)。支援的格式與尺寸取決於所選的模型。僅接受詳細資訊中將 image-to-image 對應至 /v1/images/variations 的模型;其他任何模型皆會傳回 400。

modelstring必填

模型 ID。此端點沒有預設模型。範例中使用佔位符 your-legacy-variation-model:請將其替換為詳細資訊中列出此端點的模型。

ninteger預設值: 1

要產生的圖片數量(1-10,依模型而定)。

sizestring

產生的圖片尺寸。支援的數值取決於所選的模型。

response_formatstring

傳回已產生圖片的格式。必須為 url 或 b64_json。

userstring

代表您的終端使用者的唯一識別碼,用於濫用監控。

回應

createdinteger

圖片建立時的 Unix 時間戳記。

dataarray

產生的圖片變化陣列。

每個物件包含:

  • url (string):變化圖片的 URL(若 response_format 為 url)
  • b64_json (string):Base64 編碼的圖片(若 response_format 為 b64_json)

請求

curl -X POST "https://api.tokenlab.sh/v1/images/variations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "model=your-legacy-variation-model" \
  -F "image=@cat.png" \
  -F "n=2" \
  -F "size=1024x1024"

回應

Response
{
  "created": 1706000000,
  "data": [
    {
      "url": "https://..."
    },
    {
      "url": "https://..."
    }
  ]
}

注意事項

此端點為舊版相容端點。它未包含在目前推薦的圖片模型目錄中。對於新的整合,請使用 /v1/images/edits 搭配 gpt-image-2,或使用 /v1/images/generations 搭配 operation: "image-to-image" 以及目前的圖生圖模型。

授權

BearerAuth
AuthorizationBearer <token>

API Key 驗證。請在 Dashboard > API > API Keys 建立或管理 API 金鑰。

位置: header

請求標頭

X-TokenLab-Delivery-Policy?string

單次請求傳遞策略。會覆寫 API key 與 Workspace 的預設值。系統會自動優先嘗試 TokenLab Verified,並可能在輸出、請求接受或建立持久性資源前切換至 Official 模式一次。

可選值

  • "auto"
  • "verified"
  • "official"

請求主體

multipart/form-data

回應

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json