# AI 照片去背

# 概述
以無可挑剔的精準度移除照片背景，確保影像的高品質。
* 自動背景偵測：：使用 AI 辨識並將主體與背景分離。
* 高精度編輯：：在主體周圍提供乾淨且精準的邊緣。
* 支援多種類別：人物、產品、動物、汽車、圖形等。
* 易於串接其他 AI 任務：輸出的檔案 ID 可即刻串接到其他 AI 任務。

![](https://plugins-media.makeupar.com/smb/blog/post/2023-11-03/54285311-7c65-4658-9e27-11bf5c8dfe56.jpg)
## 整合指南
* 如何執行 AI 照片去背

1. **調整來源圖片尺寸**
調整您的照片以符合支援的尺寸。細節請參考**[檔案規格與錯誤](#section/overview/File-Specs-and-Errors)**
2. **使用 File API 上傳檔案**
使用 ***/s2s/v2.0/file*** API 上傳目標使用者圖片。
  - 圖片需求
    - 細節請參考**
[檔案規格與錯誤](#section/overview/File-Specs-and-Errors)
**。
  - ***重要***：僅呼叫 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 錯誤。
3. **執行 AI 任務**
上傳完成後，使用檔案 ID 呼叫 POST 'task/sod' 執行 AI 任務，並取得用於監控的 ***task_id***。
4. **設定 webhook 或輪詢，以查詢任務狀態直到成功或錯誤**
***task_id*** 用於設定 webhook 或實作輪詢，在整個保留期間監控任務狀態。在 AI 引擎完成任務之前，狀態會維持為 running。任務處於執行狀態時不會消耗點數。處理完成後，任務狀態會變為 success 或 error。
5. **成功後取得 AI 任務的結果**
引擎成功處理您的輸入檔案並生成結果影像後，任務會變為 'success' 狀態。您會取得處理後影像的網址，以及一個 dst_id，讓您在無需重新上傳結果圖片的情況下串接另一個 AI 任務。
點數僅在這種情況下會被消耗。若引擎處理任務失敗，任務狀態會變為 'error'，且不會消耗點數。
扣除點數時，系統會優先使用接近到期的點數。若到期日相同，則扣除最早取得的點數。

* 示範情境：

常見實作案例：

![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/Transparen_Background_aca3cdbd83.jpg)

## 輸入與輸出
* 輸入
  * `Image`

- **類型：**

`image`
- **說明：**
 具有清晰前景的影像。

實際應用（輸入）：
![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/yce_removal_bg_s4_poster_1_289b8eaf81.png)


---

* 輸出
  * `前景圖片`

- **類型：**

`image`
- **說明：**
 已移除背景的影像。

實際應用（輸出）：
![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/yce_removal_bg_s4_poster_2_a6bc3c5f6a.png)
## 檔案規格與錯誤
* 支援的格式與尺寸

| 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 | 其他 |



---

## 點數消耗
| AI 功能 | 消耗的點數 |
|  --- | --- |
| AI 照片去背 V1.0 | 1 |



---

License: Privacy policy

## Servers

```
https://yce-api-01.makeupar.com
```

## Security

### BearerAuthenticationV2

使用標準的 'Bearer authentication'。請在標頭中放入您的 'API Key'：`Authorization:Bearer YOUR_API_KEY`。請注意 'Bearer' 與 'YOUR_API_KEY' 之間有一個空格。

Type: http
Scheme: bearer

## Download OpenAPI description

 - [AI 照片去背](https://docs.perfectcorp.com/_bundle/@l10n/zh-TW/reference/ai_background_removal.yaml)

## V1.0

 - [POST /s2s/v2.0/task/sod](https://docs.perfectcorp.com/zh-tw/reference/ai_background_removal/v1.0/paths/~1s2s~1v2.0~1task~1sod/post.md): 這個端點啟動背景移除流程。您必須提供從檔案上傳 API 取得的檔案 ID。任務會以非同步方式處理，您可以使用這個回應回傳的 task_id 查詢其狀態。
 - [GET /s2s/v2.0/task/sod/{task_id}](https://docs.perfectcorp.com/zh-tw/reference/ai_background_removal/v1.0/paths/~1s2s~1v2.0~1task~1sod~1%7Btask_id%7D/get.md)