# AI 替換物件

# 概述
使用 AI 替換物件，以新物件取代不想要的元素。透過這個 API，您可以僅用文字，即刻從照片中移除不想要的物件並換成新的。從包包到汽車，任何物件都能移除。​
範例：
![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/yce_web_AI_replace_S3_feature_img_02_a73a26bcc3.jpg)
對於力求完善社群媒體表現的內容創作者，AI 替換物件提供了輕鬆無礙的方式，來潤飾旅行照片或宣傳圖片。輕鬆移除並替換元素，確保您的內容脫穎而出。
![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/yce_web_AI_replace_S3_feature_img_03_42c9cd98d0.jpg)
使用 AI 替換物件創造令人驚豔的房間模擬圖，以具美感的家具與物件填滿空閒空間，改變任何空間的視覺感受。
![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/yce_web_AI_replace_S3_feature_img_04_4d2d82f76e.jpg)


---

## 檔案規格與錯誤
* 支援的格式與尺寸

| AI 功能 | 支援的尺寸 | 支援的檔案大小 | 支援的格式 |
|  --- | --- | --- | --- |
| AI 替換物件 | 長邊 <= 2048 | < 10MB | jpg/jpeg/png |

* 錯誤代碼

| 錯誤代碼 | 說明 |
|  --- | --- |
| exceed_max_filesize | 輸入檔案大小超過上限 |
| invalid_parameter | 參數值無效 |
| error_download_image | 下載來源圖片錯誤 |
| error_decode_image | 解碼來源圖片錯誤 |
| error_nsfw_content_detected | 在來源圖片中偵測到 NSFW 內容 |



---

## 點數消耗
| 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_replace.yaml)

## V1.0

 - [POST /s2s/v2.0/task/obj-replace](https://docs.perfectcorp.com/zh-tw/reference/ai_replace/v1.0/paths/~1s2s~1v2.0~1task~1obj-replace/post.md): 查詢任務狀態請參考輪詢指南。這個 API 需要來源照片、遮罩檔案，以及描述應替換遮罩區域內容的提示。
 - [GET /s2s/v2.0/task/obj-replace/{task_id}](https://docs.perfectcorp.com/zh-tw/reference/ai_replace/v1.0/paths/~1s2s~1v2.0~1task~1obj-replace~1%7Btask_id%7D/get.md)