图片加水印
描述
本接口用于图片增加水印
接口鉴权
接口地址
【POST】https://open-api.gaoding.com/api/call/watermark
请求头（request header）
字段 | 类型 | 是否必填 | 字段描述 |
app_id | string | 是 | 应用ID，获取方式：应用列表 -> 应用详情 -> APP ID |
请求体（request body）
字段 | 类型 | 是否必填 | 字段描述 |
url | string | 二个必填一个 优先级：url>file_base64 | 原图url，支持JPG、PNG格式 仅保留1个月，请及时转储 （无文件大小限制） |
file_base64 | string | 原图的base64码 （最大支持3M文件） | |
result_type | string | 否 | 结果返回类型： 枚举值：url，base64 默认url |
text | string | 是 | 水印字符 最多16个字符 |
请求体示例（url）：
{
"url":"https://matting-batch.dancf.com/cloths/20220825_143743_gaoding_imagematting_human.jpg",
"text":"稿定抠图"
}请求体示例（base64）：
{
"file_base64":"图片的base64编码",
"text":"稿定抠图"
}响应体（response body）
字段 | 类型 | 是否必存在 | 字段描述 |
result | string | 是 | url入参：结果图url，返回PNG格式，仅保留1个月，请及时转储 base64入参：返回图片base编码 |
响应示例1（模拟正常请求：url入参）：
http_status：200
response body：
{
"result": "https://gd-filems.dancf.com/gaoding/matting/watermark/b1902e3b0b1ee51938e065520c9932231661495378479.jpg"
}响应示例2（模拟正常请求：base64入参）：
http_status：200
response body：
{
"result": "图片的base64编码"
}响应示例3（模拟参数非法请求）：
http_status：400
response body：
{
"code": -10003,
"message": "InvalidArgsError"
}错误码
HTTP状态码 | 业务错误码 | 含义 |
400 | -10003 | 参数非法 |
400 | -10024 | 通过指定的upload_address 上传的的时候失败 |
400 | -10001 | 下载失败，可能是用户传的url非法，或者网络异常等原因导致下载失败 |
400 | -10002 | 解码图片失败，可能是某些格式比较特殊的图片暂时还不支持，或者图片url下载下来根本不是图像数据 |
400 | -10007 | 图片数据过大，无法处理 |
500 | 服务器错误 | |
422 | 接口入参错误 |