任务:去水印
简洁描述:使用去水印接口对图像中的指定水印区域进行智能移除。
概览
- 请求方法:
POST - 路径:
/task/pic/watermark - 内容类型:
multipart/form-data
认证方式
- Header:
Authorization: Bearer <token>
请求示例
表单参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| image_file | file | 否 | 源图像文件(二进制),与 image_url 二选一 |
| image_url | string | 否 | 源图像 URL,与 image_file 二选一 |
| mask_file | file | 否 | 蒙版图像文件(二进制),与 mask_url、rectangles 三选一,白色区域为去除区域 |
| mask_url | string | 否 | 蒙版图像 URL,与 mask_file、rectangles 三选一 |
| rectangles | string | 否 | 矩形区域列表,JSON 字符串格式,最多 50 个区域,示例:[{"x":0,"y":0,"width":100,"height":100}] |
| sync | integer | 否 | 是否等待结果就绪:0=异步(默认),1=同步 |
| callback_url | string | 否 | 回调通知地址 |
curl 示例
bash
curl -X POST "https://api.gpt.ge/task/pic/watermark" \
-H "Authorization: Bearer sk-xxxx" \
-F "image_url=https://example.com/image.png" \
-F "rectangles=[{\"x\":0,\"y\":0,\"width\":100,\"height\":100}]" \
-F "sync=1"JavaScript (fetch) 示例
javascript
const formData = new FormData();
formData.append('image_url', 'https://example.com/image.png');
formData.append('rectangles', '[{"x":0,"y":0,"width":100,"height":100}]');
formData.append('sync', '1');
fetch('https://api.gpt.ge/task/pic/watermark', {
method: 'POST',
headers: {
'Authorization': 'Bearer sk-xxxx'
},
body: formData
}).then(r => r.json()).then(console.log);Python(requests)示例
python
import requests
url = 'https://api.gpt.ge/task/pic/watermark'
headers = {
'Authorization': 'Bearer sk-xxxx'
}
files = {
'image_url': (None, 'https://example.com/image.png')
}
data = {
'rectangles': '[{"x":0,"y":0,"width":100,"height":100}]',
'sync': '1'
}
response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())返回示例(200)
json
{
"status": 200,
"data": {
"completed_at": 1742670627,
"created_at": 1742670626,
"download_time": 488,
"err_info": "",
"foreground_rect": {
"x": 133,
"y": 110,
"width": 604,
"height": 952
},
"image": "https://wxtechsz.oss-cn-shenzhen.aliyuncs.com/tasks/output/segmentation/3b950563-e53f-4036-a581-5ac04d0829b3-image.png",
"image_height": 1152,
"image_width": 864,
"output_type": 2,
"processed_at": 1742670626,
"progress": 100,
"result_type": "object",
"return_type": 1,
"state": 1,
"state_detail": "Complete",
"task_id": "3b950563-e53f-4036-a581-5ac04d0829b3",
"time_elapsed": 384.54998779296875,
"type": "auto"
}
}注意:该接口使用
multipart/form-data上传图像,mask_file、mask_url和rectangles三选一;rectangles参数格式为字符串化 JSON。