微信小程序 圖片智能裁剪能力

2022-05-12 14:59 更新

img.aiCrop

本接口應(yīng)在服務(wù)器端調(diào)用,詳細(xì)說明參見服務(wù)端API。
本接口支持云調(diào)用。需開發(fā)者工具版本 >= 1.02.1904090(最新穩(wěn)定版下載
wx-server-sdk >= 0.4.0

本接口提供基于小程序的圖片智能裁剪能力。

調(diào)用方式:

  • HTTPS 調(diào)用
  • 云調(diào)用

HTTPS 調(diào)用

請(qǐng)求地址

POST https://api.weixin.qq.com/cv/img/aicrop?img_url=ENCODE_URL&access_token=ACCESS_TOCKEN

請(qǐng)求參數(shù)

屬性 類型 默認(rèn)值 必填 說明
access_token string 接口調(diào)用憑證
img_url string 要檢測的圖片 url,傳這個(gè)則不用傳 img 參數(shù)。
img FormData form-data 中媒體文件標(biāo)識(shí),有filename、filelength、content-type等信息,傳這個(gè)則不用傳 img_url。

返回值

Object

返回的 JSON 數(shù)據(jù)包

屬性 類型 說明
errcode string 錯(cuò)誤碼
errmsg string 錯(cuò)誤信息

使用說明

說明 文件大小限制:小于2M 圖片支持使用img參數(shù)實(shí)時(shí)上傳,也支持使用img_url參數(shù)傳送圖片地址,由微信后臺(tái)下載圖片進(jìn)行識(shí)別。 ratios參數(shù)為可選,如果為空,則算法自動(dòng)裁剪最佳寬高比;如果提供多個(gè)寬高比,請(qǐng)以英文逗號(hào)“,”分隔,最多支持5個(gè)寬高比

請(qǐng)求數(shù)據(jù)示例

示例1:

curl -F 'ratios=1,2.35' "http://api.weixin.qq.com/cv/img/aicrop?img_url=ENCODE_URL&access_token=ACCESS_TOCKEN"

示例2:

curl -F 'img=@test.jpg' -F 'ratios=1,2.35' 'http://api.weixin.qq.com/cv/img/aicrop?access_token=ACCESS_TOCKEN'

返回?cái)?shù)據(jù)示例

{
   "errcode": 0,
   "errmsg": "ok",
   "results": [ //智能裁剪結(jié)果
   {
       "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
   }
}

云調(diào)用

云調(diào)用是小程序·云開發(fā)提供的在云函數(shù)中調(diào)用微信開放接口的能力,需要在云函數(shù)中通過 wx-server-sdk 使用。

接口方法

openapi.img.aiCrop
需在 config.json 中配置 img.aiCrop API 的權(quán)限,詳情

請(qǐng)求參數(shù)

屬性 類型 默認(rèn)值 必填 說明
imgUrl string 要檢測的圖片 url,傳這個(gè)則不用傳 img 參數(shù)。
img FormData form-data 中媒體文件標(biāo)識(shí),有filename、filelength、content-type等信息,傳這個(gè)則不用傳 img_url。

img 的結(jié)構(gòu)

屬性 類型 默認(rèn)值 必填 說明
contentType string 數(shù)據(jù)類型,傳入 MIME Type
value Buffer 文件 Buffer

返回值

Object

返回的 JSON 數(shù)據(jù)包

屬性 類型 說明
errCode string 錯(cuò)誤碼
errMsg string 錯(cuò)誤信息

異常

Object

拋出的異常

屬性 類型 說明
errCode string 錯(cuò)誤碼
errMsg string 錯(cuò)誤信息

errCode 的合法值

說明 最低版本

使用說明

說明 文件大小限制:小于2M 圖片支持使用img參數(shù)實(shí)時(shí)上傳,也支持使用img_url參數(shù)傳送圖片地址,由微信后臺(tái)下載圖片進(jìn)行識(shí)別。 ratios參數(shù)為可選,如果為空,則算法自動(dòng)裁剪最佳寬高比;如果提供多個(gè)寬高比,請(qǐng)以英文逗號(hào)“,”分隔,最多支持5個(gè)寬高比

返回?cái)?shù)據(jù)示例

{
   "errcode": 0,
   "errmsg": "ok",
   "results": [ //智能裁剪結(jié)果
   {
       "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
   }
}


以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)