图片智能裁剪
接口应在服务器端调用，详细说明参见服务端API。
本接口支持云调用。需开发者工具版本 >=
1.02.1904090（最新稳定版下载），wx-server-sdk>=0.4.0
接口说明
接口英文名
aiCrop
功能描述
本接口提供基于小程序的图片智能裁剪能力
注意事项
- 文件大小限制：小于2M 图片
- 支持使用img参数实时上传，也支持使用img_url参数传送图片地址，由微信后台下载图片进行识别。
- ratios参数为可选，如果为空，则算法自动裁剪最佳宽高比；如果提供多个宽高比，请以英文逗号“,”分隔，最多支持5个宽高比
调用方式
HTTPS 调用
POST https://api.weixin.qq.com/cv/img/aicrop?access_token=ACCESS_TOKEN
云调用
- 出入参和HTTPS调用相同，调用方式可查看云调用说明文档
- 接口方法为: openapi.img.aiCrop
请求参数
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_token / cloudbase_access_token | string | 是 | 接口调用凭证，该参数为 URL 参数，非 Body 参数。access_token和cloudbase_access_token二选一 其中access_token可通过getAccessToken接口获得； cloudbase_access_token可通过getOpenData接口获得 |
| img_url | string | 是 | 要检测的图片 url，传这个则不用传 img 参数。 |
| img | FormData | 是 | form-data 中媒体文件标识，有filename、filelength、content-type等信息，传这个则不用传 img_url。 |
返回参数
| 属性 | 类型 | 说明 | |
|---|---|---|---|
| errcode | number | 错误码 | |
| errmsg | string | 错误信息 | |
| results | array | 智能裁剪结果 | |
| 属性类型说明crop_leftnumber左上角xcrop_topnumber左上角ycrop_rightnumber右下角xcrop_bottomnumber右下角y | |||
| img_size | object | 图片大小 | |
| 属性类型说明wnumber宽度hnumber高度 |
调用示例
示例说明: HTTPS请求示例
请求数据示例
curl -F 'img=@test.jpg' -F 'ratios=1,2.35' 'http://api.weixin.qq.com/cv/img/aicrop?access_token=ACCESS_TOCKEN'
返回数据示例
{
"errcode": 0,
"errmsg": "ok",
"results": [ //智能裁剪结果
{
"crop_left": 112,
"crop_top": 0,
"crop_right": 839,
"crop_bottom": 727
},
{
"crop_left": 0,
"crop_top": 205,
"crop_right": 965,
"crop_bottom": 615
}
],
"img_size": { //图片大小
"w": 966,
"h": 728
}
}
错误码
| 错误码 | 错误码取值 | 解决方案 |
|---|---|---|
| -1 | system error | 系统繁忙，此时请开发者稍候再试 |
| 40001 | invalid credential access_token isinvalid or not latest | 获取 access_token 时 AppSecret 错误，或者 access_token 无效。请开发者认真比对 AppSecret 的正确性，或查看是否正在为恰当的公众号调用接口 |
| 101000 | invalid image url |