去水印

自动识别并去除图片中的水印、Logo 等不需要的叠加元素，还原干净的图片背景；也可以指定区域直接去除。铺满全图的半透明水印、网格水印，可以改用重绘模式整张重新生成。

创建任务

基本信息

项目	值
请求方法	POST
请求路径	/task/image_purify
Content-Type	application/json
鉴权方式	Authorization 请求头（直接传 API Key）

请求参数（Body）

参数名	类型	必填	默认值	说明
file_id	string	是	—	已上传图片文件的 ID
purify_method	string	否	"inpaint"	涂抹模式：inpaint（修复：找出水印后只修补水印所在的区域）/ redraw（重绘：整张图交给图片编辑模型重新生成，单独计价，见重绘模式）
purify_scope	string	否	"full_screen"	净化范围：full_screen（自动识别并去除）/ region（按 regions 给出的框直接去除）
regions	array	region 时必填	—	要直接去除的区域，1–16 个框，每项 {"x","y","w","h"}，为 0-1 画面比例，需 w>0、h>0、x+w≤1、y+h≤1

请求示例

curl -X POST https://api.ai-mcn.tv:10000/task/image_purify \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"file_id": "537489015178246"}'

region 模式示例（去除左上角的台标）：

curl -X POST https://api.ai-mcn.tv:10000/task/image_purify \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_id": "537489015178246",
    "purify_scope": "region",
    "regions": [{"x": 0.02, "y": 0.02, "w": 0.15, "h": 0.08}]
  }'

region 模式不做识别，框内全部内容都会被处理（包括画面主体），适合深色台标、图形贴片这类识别不到的元素。框越小、越贴近要去除的元素，效果越好。

重绘模式

purify_method 传 redraw 时，整张图交给图片编辑模型重新生成一张没有水印的，铺满全图的半透明水印、网格水印、和画面主体重叠的水印也能去干净：

curl -X POST https://api.ai-mcn.tv:10000/task/image_purify \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"file_id": "537489015178246", "purify_method": "redraw"}'

• 范围：purify_scope 为 full_screen 时整张图换成重绘结果；为 region 时只替换框内，框外像素与原图一致（框边有几个像素的过渡）。regions 的写法与校验同上。
• 输出：与原图同尺寸的 JPG。画面会被重新生成，小字、纹理等细节可能与原图略有不同。
• 计价：任务类型记为 image_purify_redraw，按价格表「图片去水印·重绘」一档扣费，不设免费次数；建单与查询仍走 /task/image_purify。
• 数据去向：图片会发送给中国大陆以外的第三方模型服务处理。
• 耗时：通常 30–60 秒。
• 失败：模型服务的内容审核拒绝时，任务失败、错误码 6054，不重试、积分退回；其他上游故障会自动重试，最终仍失败也退回积分。任何情况下都不会改用修复模式出结果。

成功响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178247",
    "task_type": "image_purify",
    "status": "queued"
  }
}

purify_method 为 redraw 时，task_type 为 image_purify_redraw。

---

查询任务结果

基本信息

项目	值
请求方法	GET
请求路径	/task/image_purify/{task_id}
鉴权方式	Authorization 请求头（直接传 API Key）

响应参数（output_result）

参数名	类型	说明
file_id	string	处理后的图片文件 ID

成功响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178247",
    "status": "completed",
    "progress": 100,
    "output_result": {
      "file_id": "537489015178248"
    },
    "create_time": "2026-04-05T08:00:00Z",
    "update_time": "2026-04-05T08:00:08Z"
  }
}

AI 生成内容标识

重绘模式（purify_method=redraw）的结果图片带 AI 生成内容隐式标识（只写入文件元数据，不改变画面），见 AI 生成内容标识说明。修复模式不写同合云的标识，素材自带的标识会原样保留。

错误码

错误码	HTTP 状态码	说明	解决方案
6013	400	file_id 缺失	传入 file_id 参数
6016	400	purify_method 或 purify_scope 非法，或 region 模式 regions 缺失或非法（为空、超过 16 个、坐标越界）	检查 purify_method / purify_scope / regions
6014	400	文件类型与接口不匹配	传入图片文件
6004	404	文件不存在	检查 file_id 是否正确
6017	400	文件不是可识别的图片（如伪装成 .jpg 的网页、文件头残缺），建单时直接拒绝，不创建任务、不扣费	重新导出为 JPEG / PNG 后上传
6502	401	鉴权失败	检查 Authorization 请求头
6202	402	余额不足	前往仪表盘充值
6054	—	重绘模式下图片未通过模型服务的内容审核（任务执行阶段：任务失败、积分退回，错误码见任务结果的 error_code）	换一张图片，或改用修复模式
6017	—	修复模式下，图片的实际格式本接口读不了（如扩展名是 .jpg、内容是 AVIF），error 会点名实际格式（任务执行阶段：任务失败、积分退回，错误码见任务结果的 error_code）	转成 JPEG / PNG 后重新上传并提交
6021	—	图片数据不完整或已损坏，常见于下载或上传中断造成的截断；这类图片文件头完好，建单时查不出（任务执行阶段：任务失败、积分退回，错误码见任务结果的 error_code）	重新导出或换用原图后重新提交