请先查看接入指引了解具体接入方式,再参考此文档完成接入。
名称 | 内容 |
---|---|
请求方式 | POST |
Content-Type | application/x-www-form-urlencoded |
图片要求 | 1.图片格式:JPG、JPEG、PNG、BMP等常见格式,建议使用JPG格式 2.图片文件大小:最大5MB |
Query参数:
参数 | 可选/必选 | 类型 | 说明 |
---|---|---|---|
Action | 必选 | String | 接口名,取值:ImageCut |
Version | 必选 | String | 版本号,取值:2020-08-26 |
Body参数:
参数 | 可选/必选 | 类型 | 说明 |
---|---|---|---|
image_base64 | 必选(image 与image_base64 必选其一) | String | 图片Base64编码 |
width | 必选 | Int | 要求输出图片的宽度 |
height | 必选 | Int | 要求输出图片的高度 |
cut_method | 必选 | String | 图片裁剪方法 |
gauss_padding_reserve_score
: 高斯模糊兜底,会根据图片中主体大小进行扩展
fix_size
: 固定长宽比裁剪,不进行补边
fix_size_pad_cut_text
: 其他效果同上fix_size
,但裁断比较大的文字时,会采用补边策略
gauss_padding
: 高斯模糊兜底
gauss_padding_resize
: 高斯模糊兜底,缩放到需求的长宽值
only_gauss_pad
: 只进行高斯模糊补边,不进行裁剪
fix_size_color_quantization_when_cut_text
: 智能裁剪,如果裁断文字,则选择用背景色补边
remove_edge
: 去除黑边高斯模糊边(width和height填成1,不会实际生效)
data
字段说明字段 | 类型 | 说明 |
---|---|---|
image | Image | 裁剪后的图片 |
boundingbox | BoundingBox | 裁剪框 |
Image
结构说明字段 | 类型 | 说明 |
---|---|---|
url | String | 图片链接 |
data | String | 图片的base64编码 |
BoundingBox
结构说明字段 | 类型 | 说明 |
---|---|---|
x_min | float | 检测框x 轴坐标(0~1 ) |
x_max | float | 检测框x 轴坐标(0~1 ) |
y_min | float | 检测框y 轴坐标(0~1 ) |
y_max | float | 检测框y 轴坐标(0~1 ) |
HttpCode | 错误码 | 错误消息 | 描述 |
---|---|---|---|
200 | 10000 | 无 | 请求成功 |
{ "status": 10000, "code": 10000, "time_elapsed": "1.11217161s", "request_id": "68970913035200778321605854208", "message": "Success", "data": { "boundingbox": { "x_min": 0.43375, "y_max": 1, "y_min": 0, "x_max": 0.9325 }, "image": { "url": "{图片url}", "data": {图片base64编码} } } }