移除背景
用途
移除上傳圖片的背景並回傳透明 PNG。此功能與網頁應用程式「移除背景」頁面相同。
代幣消耗： 1
方法與路徑
POST /public/v1/image-tune/remove-background
認證
請參閱認證頁面。需要 Bearer Token。
必要標頭：
Authorization: Bearer {your_api_key}
請求欄位
請以 multipart/form-data 傳送請求。
| 欄位名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
| image | file | 是 | 要移除背景的圖片（PNG 或 JPEG） |
回應
成功回應 (200 OK)：
{
"job_id": "uuid-string"
}
| 欄位 | 類型 | 說明 |
|---|---|---|
| job_id | string | 已建立作業的唯一識別碼。請使用取得作業狀態查詢結果 |
錯誤 / 驗證規則
| 情況 | HTTP 狀態 | 錯誤訊息 |
|---|---|---|
| 圖片不是有效的 PNG 或 JPEG 檔案 | 400 | "Invalid image file" |
| 無效的 API 金鑰 | 401 | "Invalid API key" |
| 欄位遺漏 | 422 | Validation error |
非同步作業行為
此端點會建立非同步作業。它會立即回傳 job_id，背景移除會在背景進行。
輪詢方法：
- 儲存回應中收到的
job_id - 輪詢
GET /public/v1/job/{job_id}確認狀態 - 當狀態變為
Succeed時，於image_urls查看結果圖片
狀態流程： Pending → Succeed 或 Failed
請求範例
cURL：
curl -X POST "https://api.aetherforgeai.com/public/v1/image-tune/remove-background" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/character.png"