{"templateId":"api_docs","sharedDataIds":{"apiDocsStore":"api-docs-@l10n/zh-TW/reference/ai_watermark_removal.yaml","sidebar":"sidebar-@l10n/zh-TW/reference/sidebars.yaml"},"props":{"definitionId":"@l10n/zh-TW/reference/ai_watermark_removal.yaml","settings":{"baseUrlPath":"/zh-tw/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可靠地偵測並移除浮水印、標誌與其他標記，同時保留影像的原始品質與細節。\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 API 上傳檔案\n\n使用 **File API**（`/s2s/v2.0/file`）上傳目標圖片。\n\n***\n\n   * 步驟 2. 取得 File API 回應\n\n回應包含：\n\n*   用於建立 AI 任務的 `file_id`。\n*   用於上傳實際圖片檔案的 `requests.url`。\n\n***\n\n   * 步驟 3. 上傳圖片到提供的網址\n\n使用 File API 回應中的 `requests.url` 上傳圖片：\n\n***\n\n   * 步驟 4. 建立 AI 任務\n\n使用 **AI 任務 API**（`/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成功的回應會包含結果圖片的下載網址：\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 Key 無效的錯誤回應：\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（現代 TLS/HTTP 支援）</br>   - jq >= 1.6（穩健的 JSON 解析） |\n| Node.js（JavaScript） | Node >= 18（支援全域 fetch） |\n| JavaScript | - Chrome / Edge >= 80</br>   - Firefox >= 74</br>   - Safari >= 13.1 |\n| PHP | PHP >= 7.4（現代 TLS/相容性），ext-curl（建議）或 allow_url_fopen=On + ext-openssl、ext-json |\n| Python | Python >= 3.10（支援 f-strings），requests >= 2.20.0 |\n| Java | Java 11+（支援 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-TW","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"master"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/zh-tw/reference/ai_watermark_removal","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}