AI 浮水印移除
AI 驅動的浮水印移除
可靠地偵測並移除浮水印、標誌與其他標記，同時保留影像的原始品質與細節。
請負責地使用此工具，避免不道德的應用，例如為未經授權的商業用途移除浮水印。尊重影像的預期用途，並遵循合理使用原則。
- AI 浮水印移除使用指南
本指南說明如何使用 AI 浮水印移除上傳圖片、準備參考物件，以及建立任務。
- 步驟 1. 使用 File API 上傳檔案
使用 File API（/s2s/v2.0/file）上傳目標圖片。
- 步驟 2. 取得 File API 回應
回應包含：
- 用於建立 AI 任務的
file_id。 - 用於上傳實際圖片檔案的
requests.url。
- 步驟 3. 上傳圖片到提供的網址
使用 File API 回應中的 requests.url 上傳圖片：
- 步驟 4. 建立 AI 任務
使用 AI 任務 API（/s2s/v2.0/task/wmk-removal）建立 AI 任務。
- 步驟 5. 輪詢任務結果
使用任務 ID 查詢狀態：
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. 取得結果
成功的回應會包含結果圖片的下載網址：
{
"status": 200,
"data": {
"error": null,
"results": {
"url": "https://yce-us.s3-accelerate.amazonaws.com/demo/ttl30/...signature..."
},
"task_status": "success"
}
}API Key 無效的錯誤回應：
{
"status": 401,
"error": "Unauthorized",
"error_code": "InvalidAccessToken"
}應用案例： 
- 支援的格式與尺寸
| 類型 | 支援的尺寸 | 支援的檔案大小 | 支援的格式 |
|---|---|---|---|
| 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（現代 TLS/HTTP 支援） - jq >= 1.6（穩健的 JSON 解析） |
| Node.js（JavaScript） | Node >= 18（支援全域 fetch） |
| JavaScript | - Chrome / Edge >= 80 - Firefox >= 74 - Safari >= 13.1 |
| PHP | PHP >= 7.4（現代 TLS/相容性），ext-curl（建議）或 allow_url_fopen=On + ext-openssl、ext-json |
| Python | Python >= 3.10（支援 f-strings），requests >= 2.20.0 |
| Java | Java 11+（支援 HttpClient），Jackson Databind >= 2.12.0 |
下载 OpenAPI 描述
语言
服务器
https://yce-api-01.makeupar.com