圖像
建立圖片變化
建立指定圖片的變化版本
概覽
此端點支援現有的 OpenAI Variations 用戶端。若要使用新的圖生圖功能,請將 /v1/images/edits 或 /v1/images/generations 搭配目前的圖生圖模型使用。請求使用 multipart/form-data。
請求主體
此端點為同步處理:回應會直接包含最終圖片,而非任務狀態。請將您的 HTTP 用戶端逾時時間設定為至少 120s。
Multipart 來源圖片。檔案與完整的請求主體大小皆不可超過 50 MiB(超過限制之上傳將傳回 413)。支援的格式與尺寸取決於所選的模型。僅接受詳細資訊中將 image-to-image 對應至 /v1/images/variations 的模型;其他任何模型皆會傳回 400。
模型 ID。此端點沒有預設模型。範例中使用佔位符 your-legacy-variation-model:請將其替換為詳細資訊中列出此端點的模型。
1要產生的圖片數量(1-10,依模型而定)。
產生的圖片尺寸。支援的數值取決於所選的模型。
傳回已產生圖片的格式。必須為 url 或 b64_json。
代表您的終端使用者的唯一識別碼,用於濫用監控。
回應
圖片建立時的 Unix 時間戳記。
產生的圖片變化陣列。
每個物件包含:
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"回應
{
"created": 1706000000,
"data": [
{
"url": "https://..."
},
{
"url": "https://..."
}
]
}注意事項
此端點為舊版相容端點。它未包含在目前推薦的圖片模型目錄中。對於新的整合,請使用 /v1/images/edits 搭配 gpt-image-2,或使用 /v1/images/generations 搭配 operation: "image-to-image" 以及目前的圖生圖模型。
授權
BearerAuth API Key 驗證。請在 Dashboard > API > API Keys 建立或管理 API 金鑰。
位置: header
請求標頭
單次請求傳遞策略。會覆寫 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