跳至主要內容

圖層分離

用途​

此端點將上傳的影像分離為圖層。根據關鍵字將影像的特定元素分離，提取為個別圖層。

方法與路徑​

  • HTTP Method: POST
  • Path: /public/v1/image-tune/split-layer

認證​

此端點需要 Bearer Token 認證。詳細資訊請參閱認證指南。

必要標頭：

Authorization: Bearer {your_api_key}

請求欄位​

表單資料 (multipart/form-data)​

欄位名類型必填說明
imagefile必填要分離為圖層的原始影像檔案 (PNG, JPG, JPEG 等)
keywordstring必填指定要分離元素的關鍵字

Keyword 指南​

  • 輸入描述要分離的影像元素的關鍵字
  • 例如："arm", "body", "leg"

回應​

JobIdResponse​

欄位名類型說明
job_idUUID已建立作業的唯一識別碼。使用此 ID 查詢作業狀態

錯誤 / 驗證規則​

HTTP 狀態碼錯誤情境說明
400 Bad RequestInvalid image fileInvalid image file
401 Unauthorized認證失敗無效的 API 金鑰或遺漏的認證標頭
404 Not Found使用者不存在找不到 API 金鑰連結的使用者
422 Unprocessable Entity驗證失敗必填欄位遺漏

非同步作業行為​

此端點以非同步方式處理。請求立即回傳 job_id，實際圖層分離處理於背景進行。

作業流程：

  1. 傳送影像檔案與關鍵字後立即回傳 job_id
  2. 背景進行圖層分離處理
  3. 使用 GET /job/{job_id} 端點輪詢確認狀態
  4. status 變更為 Succeed 時，於 image_urls 查看分離的圖層影像 URL

輪詢間隔： 建議 1-2 秒

請求範例​

cURL​

curl -X POST "https://api.aetherforgeai.com/public/v1/image-tune/split-layer" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/your/image.png" \
-F "keyword=character"

回應範例​

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000"
}