{"templateId":"api_docs","sharedDataIds":{"apiDocsStore":"api-docs-@l10n/zh-CN/reference/ai_watermark_removal.yaml","sidebar":"sidebar-@l10n/zh-CN/reference/sidebars.yaml"},"props":{"definitionId":"@l10n/zh-CN/reference/ai_watermark_removal.yaml","settings":{"baseUrlPath":"/zh-cn/reference/ai_watermark_removal"},"disableAutoScroll":true,"seo":{"title":"AI 水印移除","description":"YouCam API documentation by Perfect Corp. Learn how to use Skin analysis API, Virtual try-on API, Image editing API, and Video generative AI APIs.","siteUrl":"https://docs.perfectcorp.com","keywords":"AI Skin Analysis, AI Clothes, AI Hairstyle, AI Outfits","image":"/assets/favicon.cd6fa4d833b2a573b3c6dae68386b293da205b203402cb0c97b80bd2acc07ea2.8351e24f.png"},"dynamicMarkdocComponents":[],"metadata":{"type":"openapi","title":"AI 水印移除","version":"","description":"# 概览\nAI 去水印\n\n稳定检测并消除水印、logo 及其他标记，原图的画质与细节原样保住。\n\n    > 请合规使用本工具，避免用于不道德的场景，例如为未经授权的商业用途去除水印。请尊重图片的原始用途，遵循合理使用的原则。\n\n![](https://d32qvgpd29lguw.cloudfront.net/Watermark_Remover_BA_Image_24bf9f2ed1.png)\n\n---\n\n## 接入指南\n\n* AI 去水印使用指引\n\n本指引说明如何上传图片、准备参考服装，以及用 AI 去水印创建虚拟试穿任务。\n\n***\n\n   * 第 1 步：用 File 接口上传文件\n\n用 **File 接口**（`/s2s/v2.0/file`）上传目标图片。\n\n***\n\n   * 第 2 步：取得 File 接口响应\n\n响应中包含：\n\n*   用于创建 AI 任务的 `file_id`。\n*   用于上传实际图片文件的 `requests.url`。\n\n***\n\n   * 第 3 步：把图片上传到提供的 URL\n\n用 File 接口响应中的 `requests.url` 上传图片：\n\n***\n\n   * 第 4 步：创建 AI 任务\n\n用 **AI 任务接口**（`/s2s/v2.0/task/wmk-removal`）创建 AI 任务。\n\n***\n\n   * 第 5 步：轮询任务结果\n\n用任务 ID 查看状态：\n\n```bash\ncurl --request GET \\\n  --url https://yce-api-01.makeupar.com/s2s/v2.0/task/wmk-removal/<YOUR_TASK_ID> \\\n  --header 'Authorization: Bearer YOUR_API_KEY' \\\n  --header 'content-type: application/json'\n```\n\n***\n\n   * 第 6 步：取回结果\n\n成功的响应会给出结果图片的下载 URL：\n\n```json\n{\n  \"status\": 200,\n  \"data\": {\n    \"error\": null,\n    \"results\": {\n \"url\": \"https://yce-us.s3-accelerate.amazonaws.com/demo/ttl30/...signature...\"\n    },\n    \"task_status\": \"success\"\n  }\n}\n```\n\nAPI 密钥无效的报错响应：\n\n```json\n{\n  \"status\": 401,\n  \"error\": \"Unauthorized\",\n  \"error_code\": \"InvalidAccessToken\"\n}\n```\n\n---\n\n应用场景：\n![](https://d32qvgpd29lguw.cloudfront.net/Watermark_Remover_BA_2_c8bbf561af.png)\n\n\n\n## 文件规格与错误码\n* 支持的格式与尺寸\n\n|类型|支持尺寸|支持文件大小|支持格式|\n|  ---- | ---- | ---- | ---- |\n| AI 去水印 | 最长边 4096 px | < 10MB | jpg/png |\n\n    > 未经版权方同意或出于未经授权的目的去除水印可能违法。请确保您对该图片拥有相应权利。\n\n* 错误码\n\n| 错误码 | 说明 |\n| ---------- | ----------- |\n| invalid_parameter |参数缺失或取值无效。 |\n| error_download_image | 图片下载失败。 |\n| exceed_max_filesize | 图片过大。文件大小不得超过 10 MB，长边不得超过 4096 像素。 |\n| error_below_min_image_size | 图片过小。长边不得小于 128 像素。 |\n| error_nsfw_content_detected | 在结果图中检测到疑似不适宜内容（NSFW）。 |\n| error_editing_failed | 编辑失败：结果图与原图过于相似。 |\n| unknown_internal_error | 处理本次请求时我们这边出了错。 |\n\n\n* 运行环境与依赖\n\n| 示例代码语言 / 工具 | 建议运行时版本 |\n|---|---|\n| cURL | - bash >= 3.2</br>   - curl >= 7.58 (modern TLS/HTTP support)</br>   - jq >= 1.6 (robust JSON parsing) |\n| Node.js (JavaScript) | Node >= 18 (for global fetch) |\n| JavaScript | - Chrome / Edge >= 80</br>   - Firefox >= 74</br>   - Safari >= 13.1 |\n| PHP | PHP >= 7.4 (for modern TLS/compat), ext-curl (recommended) or allow_url_fopen=On + ext-openssl, ext-json |\n| Python | Python >= 3.10 (for f-strings), requests >= 2.20.0 |\n| Java | Java 11+ (for HttpClient), Jackson Databind >= 2.12.0 |\n\n---\n\n## 点数消耗\n\n| AI 功能 | 消耗点数 |\n|---|---|\n| AI 去水印 | 1 |\n\n---\n"},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"docs.perfectcorp.com","port":4000,"ipAddress":"216.73.216.199"},"lang":"zh-CN","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"master"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/zh-cn/reference/ai_watermark_removal","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}