AI 照片去背
以無可挑剔的精準度移除照片背景，確保影像的高品質。
- 自動背景偵測：：使用 AI 辨識並將主體與背景分離。
- 高精度編輯：：在主體周圍提供乾淨且精準的邊緣。
- 支援多種類別：人物、產品、動物、汽車、圖形等。
- 易於串接其他 AI 任務：輸出的檔案 ID 可即刻串接到其他 AI 任務。
- 如何執行 AI 照片去背
調整來源圖片尺寸
調整您的照片以符合支援的尺寸。細節請參考**檔案規格與錯誤**使用 File API 上傳檔案
使用 /s2s/v2.0/file API 上傳目標使用者圖片。圖片需求
- 細節請參考**檔案規格與錯誤**。
重要：僅呼叫 File API 並不會上傳您的檔案。您必須手動上傳檔案到File API 回應中提供的網址。該網址就是您的上傳目的地，請確保檔案成功傳輸到該處後再繼續。
在呼叫 AI API 之前，請確保您的檔案已成功上傳。使用 File API 取得上傳網址，然後將檔案上傳到該位置。上傳完成後，您會在回應中取得 file_id，這個 ID 就是您用於存取該檔案相關 AI 功能的依據。警告： 請注意，若您未將檔案上傳到 File API 回應中提供的網址，使用 AI API 時會得到 500 Server Error / unknown_internal_error 或 404 Not Found 錯誤。
執行 AI 任務
上傳完成後，使用檔案 ID 呼叫 POST 'task/sod' 執行 AI 任務，並取得用於監控的 task_id。設定 webhook 或輪詢，以查詢任務狀態直到成功或錯誤
task_id 用於設定 webhook 或實作輪詢，在整個保留期間監控任務狀態。在 AI 引擎完成任務之前，狀態會維持為 running。任務處於執行狀態時不會消耗點數。處理完成後，任務狀態會變為 success 或 error。成功後取得 AI 任務的結果
引擎成功處理您的輸入檔案並生成結果影像後，任務會變為 'success' 狀態。您會取得處理後影像的網址，以及一個 dst_id，讓您在無需重新上傳結果圖片的情況下串接另一個 AI 任務。 點數僅在這種情況下會被消耗。若引擎處理任務失敗，任務狀態會變為 'error'，且不會消耗點數。
扣除點數時，系統會優先使用接近到期的點數。若到期日相同，則扣除最早取得的點數。
- 示範情境： 常見實作案例：
- 支援的格式與尺寸
| AI 功能 | 支援的尺寸 | 檔案大小 | 接受的格式 |
|---|---|---|---|
| AI 照片去背 | 輸入與輸出圖片的建議與限制如下： 解析度：4096 × 4096 像素（最長邊不得超過 4096 像素） | <10MB | JPG 與 PNG |
- 錯誤代碼
| 錯誤代碼 | 說明 |
|---|---|
| exceed_max_filesize | 輸入檔案大小超過上限 |
| invalid_parameter | 參數值無效 |
| error_download_image | 下載來源圖片錯誤 |
| error_download_mask | 下載遮罩圖片錯誤 |
| error_decode_image | 解碼來源圖片錯誤 |
| error_decode_mask | 解碼遮罩圖片錯誤 |
| error_download_video | 下載來源影片錯誤 |
| error_decode_video | 解碼來源影片錯誤 |
| error_nsfw_content_detected | 在來源圖片中偵測到 NSFW 內容 |
| error_no_face | 來源圖片未偵測到臉部 |
| error_pose | 在來源圖片偵測姿勢失敗 |
| error_face_parsing | 在來源圖片進行人臉分割失敗 |
| error_inference | 推論流程錯誤 |
| exceed_nsfw_retry_limits | 超過重試上限，以避免生成 NSFW 圖片 |
| error_upload | 上傳結果圖片錯誤 |
| error_multiple_people | 在來源圖片中偵測到多人 |
| error_no_shoulder | 來源圖片中肩膀不可見 |
| error_large_face_angle | 上傳圖片的臉部角度過大 |
| error_hair_too_short | 輸入的頭髮過短 |
| error_unexpected_video_duration | 影片長度等於 dstDuration |
| error_bald_image | 輸入的髮型為禿頭 |
| error_unsupport_ratio | 輸入圖片的長寬比不受支援 |
| unknown_internal_error | 其他 |