图片去水印 API 接入教程：用一个 POST 请求完成图片处理

图片去水印 API 接入教程用一个 POST 请求完成图片处理在内容整理、电商素材制作和图片归档等场景中经常需要对已获授权的图片进行水印清理。如果逐张手动处理不仅耗时也很难接入自动化工作流。本文介绍如何调用追梦 API 的图片去水印接口。开发者只需提供一张公网可访问的图片地址即可通过标准 HTTP 请求提交处理任务。请仅处理本人拥有版权或已获得合法授权的图片并遵守相关法律法规与内容平台规则。接口概览请求地址https://api.zhuimengapi.com/api/v1/remove_watermark请求方式POST内容类型application/json鉴权请求头X-API-Key调用接口前需要先准备自己的 API Key。密钥格式示例为RPA-xxxxxxxxAPI Key 应保存在服务端环境变量或密钥管理服务中不要直接写入网页前端也不要提交到公开代码仓库。请求参数接口支持通过图片 URL 提交图片也提供 Base64 字符串参数。参数类型必填说明imgUrlstring是图片的公网可访问 URL推荐使用image_base64string否图片 Base64 内容不包含data:image/...;base64,前缀使用imgUrl时要确保接口服务器可以直接访问该地址。如果图片 URL 需要登录、存在防盗链限制或只能在内网访问接口可能无法读取图片。cURL 调用示例下面是最精简的 URL 图片调用方式curl-XPOSThttps://api.zhuimengapi.com/api/v1/remove_watermark\-HX-API-Key: RPA-xxxxxxxx\-HContent-Type: application/json\-d{ imgUrl: https://example.com/images/sample.jpg }如果业务中已经取得了图片的 Base64 内容也可以一并传入{image_base64:BASE64_IMAGE_CONTENT,imgUrl:https://example.com/images/sample.jpg}返回结果调用成功后返回数据中会包含状态码与处理后的图片地址{code:200,image_url:https://example.com/result/processed-image.jpg}字段含义如下字段类型说明codeint200表示处理成功image_urlstring处理后图片的公开访问地址结果图片会在 24 小时后自动清理。如果需要长期保存应在接口返回成功后及时下载并转存到自己的对象存储或文件服务器。JavaScript 服务端示例以下代码适用于支持原生fetch的 Node.js 环境constresponseawaitfetch(https://api.zhuimengapi.com/api/v1/remove_watermark,{method:POST,headers:{Content-Type:application/json,X-API-Key:process.env.ZHUIMENG_API_KEY,},body:JSON.stringify({imgUrl:https://example.com/images/sample.jpg,}),},);constresultawaitresponse.json();if(response.okresult.code200){console.log(处理结果,result.image_url);}else{console.error(图片处理失败,result);}接入建议正式接入时建议同时做好以下几项工作在服务端保管 API Key避免密钥泄漏。提交前校验 URL 格式减少无效请求。同时判断 HTTP 状态与响应中的code字段。为网络超时和临时失败设置有限次数的重试。成功后及时转存image_url对应的文件。记录请求时间和业务流水号但不要在日志中输出完整 API Key。通过这个接口可以把图片去水印能力接入后台系统、内容工具或自动化流程