# AI 水印移除

# 概览
AI 去水印
稳定检测并消除水印、logo 及其他标记，原图的画质与细节原样保住。
> 请合规使用本工具，避免用于不道德的场景，例如为未经授权的商业用途去除水印。请尊重图片的原始用途，遵循合理使用的原则。

![](https://d32qvgpd29lguw.cloudfront.net/Watermark_Remover_BA_Image_24bf9f2ed1.png)


---

## 接入指南
* AI 去水印使用指引

本指引说明如何上传图片、准备参考服装，以及用 AI 去水印创建虚拟试穿任务。


---

* 第 1 步：用 File 接口上传文件

用 **File 接口**（`/s2s/v2.0/file`）上传目标图片。


---

* 第 2 步：取得 File 接口响应

响应中包含：
* 用于创建 AI 任务的
`file_id`
。
* 用于上传实际图片文件的
`requests.url`
。



---

* 第 3 步：把图片上传到提供的 URL

用 File 接口响应中的 `requests.url` 上传图片：


---

* 第 4 步：创建 AI 任务

用 **AI 任务接口**（`/s2s/v2.0/task/wmk-removal`）创建 AI 任务。


---

* 第 5 步：轮询任务结果

用任务 ID 查看状态：

```bash
curl --request GET \
  --url https://yce-api-01.makeupar.com/s2s/v2.0/task/wmk-removal/<YOUR_TASK_ID> \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'content-type: application/json'
```


---

* 第 6 步：取回结果

成功的响应会给出结果图片的下载 URL：

```json
{
  "status": 200,
  "data": {
    "error": null,
    "results": {
 "url": "https://yce-us.s3-accelerate.amazonaws.com/demo/ttl30/...signature..."
    },
    "task_status": "success"
  }
}
```
API 密钥无效的报错响应：

```json
{
  "status": 401,
  "error": "Unauthorized",
  "error_code": "InvalidAccessToken"
}
```


---

应用场景：
![](https://d32qvgpd29lguw.cloudfront.net/Watermark_Remover_BA_2_c8bbf561af.png)
## 文件规格与错误码
* 支持的格式与尺寸

| 类型 | 支持尺寸 | 支持文件大小 | 支持格式 |
|  --- | --- | --- | --- |
| AI 去水印 | 最长边 4096 px | < 10MB | jpg/png |

> 未经版权方同意或出于未经授权的目的去除水印可能违法。请确保您对该图片拥有相应权利。

* 错误码

| 错误码 | 说明 |
|  --- | --- |
| invalid_parameter | 参数缺失或取值无效。 |
| error_download_image | 图片下载失败。 |
| exceed_max_filesize | 图片过大。文件大小不得超过 10 MB，长边不得超过 4096 像素。 |
| error_below_min_image_size | 图片过小。长边不得小于 128 像素。 |
| error_nsfw_content_detected | 在结果图中检测到疑似不适宜内容（NSFW）。 |
| error_editing_failed | 编辑失败：结果图与原图过于相似。 |
| unknown_internal_error | 处理本次请求时我们这边出了错。 |

* 运行环境与依赖

| 示例代码语言 / 工具 | 建议运行时版本 |
|  --- | --- |
| cURL | - bash >= 3.2   - curl >= 7.58 (modern TLS/HTTP support)   - jq >= 1.6 (robust JSON parsing) |
| Node.js (JavaScript) | Node >= 18 (for global fetch) |
| JavaScript | - Chrome / Edge >= 80   - Firefox >= 74   - Safari >= 13.1 |
| PHP | PHP >= 7.4 (for modern TLS/compat), ext-curl (recommended) or allow_url_fopen=On + ext-openssl, ext-json |
| Python | Python >= 3.10 (for f-strings), requests >= 2.20.0 |
| Java | Java 11+ (for HttpClient), Jackson Databind >= 2.12.0 |



---

## 点数消耗
| AI 功能 | 消耗点数 |
|  --- | --- |
| AI 去水印 | 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_watermark_removal.yaml)

## V1.0

 - [POST /s2s/v2.0/task/wmk-removal](https://docs.perfectcorp.com/zh-cn/reference/ai_watermark_removal/v1.0/paths/~1s2s~1v2.0~1task~1wmk-removal/post.md): AI 任务是异步处理的。功能支持 Webhook 时，优先用 Webhook 来接收完成通知。配置好您的 Webhook 端点、校验 Webhook 签名，收到 `success` 或 `error` 通知后，用收到的 `task_id` 查询任务结果。配置与校验的细节请见 [Webhook 接入指南](/develop/webhook)。 若功能不支持 Webhook，或您的接入方式用不了 We
 - [GET /s2s/v2.0/task/wmk-removal/{task_id}](https://docs.perfectcorp.com/zh-cn/reference/ai_watermark_removal/v1.0/paths/~1s2s~1v2.0~1task~1wmk-removal~1%7Btask_id%7D/get.md)