# 图片智能裁剪

接口应在服务器端调用,详细说明参见服务端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<object> 智能裁剪结果
属性 类型 说明
crop_left number 左上角x
crop_top number 左上角y
crop_right number 右下角x
crop_bottom number 右下角y
img_size object 图片大小
属性 类型 说明
w number 宽度
h number 高度

# 调用示例

示例说明: 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