Skip to content

去水印(Remove Watermark) ​

自动检测并去除图片中的水印,恢复图片原始内容。默认 2.0:按原图尺寸出图,也可指定 1K / 1.5K / 2K。可选 userPrompt 描述水印位置;不传则自动检测。原图有透明通道则自动保留 RGBA,无则不输出透明底;无开关、不强制 RGBA。传 engine=v1 则走 1.0,保持原分辨率。

在编辑器中试用:去水印。

基本信息 ​

项目值
接口路径POST /image/remove-watermark
所需 Scoperemove_watermark 或 *
任务类型异步,返回 taskId
分辨率2.0 默认 original_pixels(原图尺寸)+ 1k 计费档;也可指定宽高比与 1k / 1.5k / 2k。1.0 保持原图像素

请求参数 ​

json
{
  "requestId": "可选,调用方自定义唯一 ID",
  "url": "含水印图片的公开 HTTPS URL(必填)",
  "engine": "可选,v2(默认)或 v1",
  "ar": "可选,默认 original_pixels。engine=v1 时忽略",
  "outputResolution": "可选,1k / 1.5k / 2k,默认 1k。engine=v1 时忽略",
  "userPrompt": "可选,水印位置或描述。空或省略则自动检测。engine=v1 时忽略"
}

参数说明 ​

参数类型必填说明
requestIdstring否调用方请求 ID,用于幂等去重
urlstring是含水印图片的公开 HTTPS URL
enginestring否v2(默认,可选尺寸)或 v1(保持原分辨率)
arstring否输出宽高比。缺省 original_pixels(尽量保持原图像素:边长对齐 32,长边小于 512 会放大,大于 4096 会缩小)。也可传 original(按所选分辨率档缩放并保持原图比例),或 1:1、16:9、9:16、4:3、3:4、3:2、2:3 这类 宽:高。engine=v1 时忽略
outputResolutionstring否1k / 1.5k / 2k。缺省 1k。original_pixels 时只影响计费档,不改变画布。engine=v1 时忽略
userPromptstring否水印位置或描述,最多 100 字。空或省略则自动检测。超长会截断。engine=v1 时忽略

url 须为服务能访问的 HTTPS 地址。本地文件先调用 POST /images/upload,把返回的 data.url 作为 url。

原图有透明通道则自动保留 RGBA,无则不输出透明底。没有 transparent 开关,客户端也不要传该字段。


请求示例 ​

bash
curl -s -X POST \
  -H "Authorization: Bearer $TUSEN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/watermarked.jpg"
  }' \
  "https://magiqsight.com/openapi/v1/image/remove-watermark"

响应示例 ​

json
{
  "code": 0,
  "data": {
    "requestId": "req_abc123",
    "taskId": "task_xyz"
  },
  "msg": ""
}

获得 taskId 后,通过 GET /tasks/{taskId} 轮询结果。

任务成功(status: 1)后,resultType 为 image,结果在 imageUrls。任务失败(status: 2)时查看 resultMetadata。

默认 2.0,尽量保持原图尺寸。需要指定比例或更大画布时传 ar 与 outputResolution。要指定水印位置时传 userPrompt。原图有透明通道则自动保留 RGBA。要 1.0 保原分辨率时传 "engine": "v1"。

妙图设计 API Beta