全屏去水印-高级API

免费体验

将高级 AI 图片去水印能力集成到产品或工作流程中，自动识别并清除图片中的水印、文字、Logo、商标和印章，智能填充被移除区域并与周围像素自然融合，输出干净自然的结果图。

接口返回的链接一般有效期为 1 小时，请及时下载存储。

鉴权

每个 API 请求都必须在请求头中携带你的 API Key。请按当前文档中的请求方式和参数说明，将其作为 X-API-KEY 请求头传入。

X-API-KEY: YOUR_API_KEY

创建全屏去水印-高级任务

POST /api/tasks/visual/advanced/watermark-remove

请求参数

image_url string 可选

图片下载地址。支持 HTTP 和 OSS 协议，最长 512 个字符，下载超时 20 秒；同时传入两种图片来源时，优先级低于 image_file。

二选一必填
image_file file 可选

图片文件（二进制）。同时传入 image_file 与 image_url 时优先使用 image_file；以服务端接收到的文件为准，大小必须小于 50MB。

图片上传要求请参看使用规范与限制#5。

sync integer 可选

同步或异步处理。

  • 0：异步返回 task_id，随后轮询查询接口；
  • 1：同步等待处理完成并直接返回结果。

返回参数

status number

HTTP 响应状态码，详见 状态码说明。

  • 200：请求成功；
  • 非 200：请求失败。
message string

接口返回消息。任务失败时可参考此字段，或携带该信息联系客服。

data.task_id string

异步任务 ID，用于轮询全屏去水印-高级结果。

status number

HTTP 响应状态码，详见 状态码说明。

  • 200：请求成功；
  • 非 200：请求失败。
message string

接口返回消息。任务失败时可参考此字段，或携带该信息联系客服。

data.task_id string

全屏去水印-高级任务 ID。任务失败时请携带此参数联系客服。

data.created_at number

任务创建时间戳。

data.processed_at number

任务开始处理时间戳。

data.completed_at number

任务完成时间戳。

data.image_url string

去水印结果图片下载 URL 或 base64 数据；URL 有效期一般为 1 小时。

data.return_type number

结果返回方式。

data.type number

结果返回方式的兼容字段。

data.progress number

任务处理进度，范围为 0～100；100 表示处理完成。

data.state number

任务处理状态，详见 状态码说明。

  • 1：成功；
  • 0 或 大于 1：处理中；
  • 小于 0：失败；
  • -8：处理超时，最长处理时间为 600 秒；
  • -7：无效图片文件；
  • -5：URL 图片超过 50MB；
  • -3：服务器下载图片失败。
data.state_detail string

任务状态详情。

data.time_elapsed number

任务处理耗时。

data.use_point number

本次任务扣费点数。

查询全屏去水印-高级结果

异步请求建议每 1 秒 轮询一次结果，本接口最大轮询时长为 600 秒；累计轮询超过该时长仍未返回结果，即可视为超时失败。

GET /api/tasks/visual/advanced/watermark-remove/{task_id}

路径参数

task_id string 必填

创建异步全屏去水印-高级任务后返回的任务 ID，用于查询处理结果。

返回参数

status number

HTTP 响应状态码，详见 状态码说明。

  • 200：请求成功；
  • 非 200：请求失败。
message string

接口返回消息。任务失败时可参考此字段，或携带该信息联系客服。

data.task_id string

全屏去水印-高级任务 ID。任务失败时请携带此参数联系客服。

data.created_at number

任务创建时间戳。

data.processed_at number

任务开始处理时间戳。

data.completed_at number

任务完成时间戳。

data.image_url string

去水印结果图片下载 URL 或 base64 数据；URL 有效期一般为 1 小时。

data.return_type number

结果返回方式。

data.type number

结果返回方式的兼容字段。

data.progress number

任务处理进度，范围为 0～100；100 表示处理完成。

data.state number

任务处理状态，详见 状态码说明。

  • 1：成功；
  • 0 或 大于 1：处理中；
  • 小于 0：失败；
  • -8：处理超时，最长处理时间为 600 秒；
  • -7：无效图片文件；
  • -5：URL 图片超过 50MB；
  • -3：服务器下载图片失败。
data.state_detail string

任务状态详情。

data.time_elapsed number

任务处理耗时。

data.use_point number

本次任务扣费点数。

使用规范与限制

  1. 接口返回的链接有效期为 1 小时，请及时下载存储。

  2. HTTP status 为 200 表示 HTTP 请求成功；查询结果返回 200 且 data.state 为 1 时表示自动去水印成功，详见 状态码说明。

  3. URL 作为参数传递时，请遵守 URL 编码规范，避免参数解析异常。

  4. 您不得利用本服务从事任何违反法律法规或侵犯他人合法权利的行为。

  5. 上传图片需符合以下格式和大小限制。

    格式大小
    PNG、WebP、JPEG/JPG小于 50MB