# AI 替换物件

# 概览
AI 替换物件可以拿新物体换掉您不想要的元素。调用这个接口，您只要用文字描述，就能即刻去除照片中的多余物体、换上新的。从包到车，想换就换。​
示例：
![](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 鉴权。把您的 API 密钥放进请求头： `Authorization:Bearer YOUR_API_KEY`。请注意 'Bearer' 与 'YOUR_API_KEY' 之间有一个空格。

Type: http
Scheme: bearer

## Download OpenAPI description

 - [AI 替换物件](https://docs.perfectcorp.com/_bundle/@l10n/zh-CN/reference/ai_replace.yaml)

## V1.0

 - [POST /s2s/v2.0/task/obj-replace](https://docs.perfectcorp.com/zh-cn/reference/ai_replace/v1.0/paths/~1s2s~1v2.0~1task~1obj-replace/post.md): 查询任务状态请参见轮询指南。本接口需要源图片、蒙版文件，以及描述蒙版区域要替换成什么的提示词。
 - [GET /s2s/v2.0/task/obj-replace/{task_id}](https://docs.perfectcorp.com/zh-cn/reference/ai_replace/v1.0/paths/~1s2s~1v2.0~1task~1obj-replace~1%7Btask_id%7D/get.md)