图像处理接口文档

一、接口介绍

1.1 接口功能

本页面提供多项图像处理能力相关的API。

1.2 接口限制

内测期间,对于已认证的订阅号、服务号、企业号、小程序,我们提供了 500 次/天 的免费额度供开发者使用。如免费额度无法满足使用需求,开发者可以【申请调整 OCR 接口调用次数上限】为主题,发送邮件至:wx_city@tencent.com 申请调整,并在正文中注明小程序帐号 AppID、业务主体、业务背景、服务流程载体、日调用量预估。调整的额度仅在内测期间有效。

二、二维码/条码识别接口

2.1 请求示例

地址:
https://api.weixin.qq.com/cv/img/qrcode?img_url=ENCODE_URL&access_token=ACCESS_TOCKEN
示例1:
curl 'https://api.weixin.qq.com/cv/img/qrcode?img_url=ENCODE_URL&access_token=ACCESS_TOCKEN'
示例2:
curl -F 'img=@test.jpg' 'https://api.weixin.qq.com/cv/img/qrcode?access_token=ACCESS_TOCKEN'

说明:

  1. 图片支持使用img参数实时上传,也支持使用img_url参数传送图片地址,由微信后台下载图片进行识别
  2. 文件大小限制:小于2M
  3. 支持条码、二维码、DataMatrix和PDF417的识别。
  4. 二维码、DataMatrix会返回位置坐标,条码和PDF417暂不返回位置坐标。

2.2返回参数样例

{
    "errcode": 0, 
    "errmsg": "ok", 
    "code_results": [
        {
            "type_name": "QR_CODE", 
            "data": "https://www.qq.com", 
            "pos": {
                "left_top": {
                    "x": 585, 
                    "y": 378
                }, 
                "right_top": {
                    "x": 828, 
                    "y": 378
                }, 
                "right_bottom": {
                    "x": 828, 
                    "y": 618
                }, 
                "left_bottom": {
                    "x": 585, 
                    "y": 618
                }
            }
        }, 
        {
            "type_name": "QR_CODE", 
            "data": "https://mp.weixin.qq.com", 
            "pos": {
                "left_top": {
                    "x": 185, 
                    "y": 142
                }, 
                "right_top": {
                    "x": 396, 
                    "y": 142
                }, 
                "right_bottom": {
                    "x": 396, 
                    "y": 353
                }, 
                "left_bottom": {
                    "x": 185, 
                    "y": 353
                }
            }
        }, 
        {
            "type_name": "EAN_13", 
            "data": "5906789678957"
        }, 
        {
            "type_name": "CODE_128", 
            "data": "50090500019191"
        }
    ], 
    "img_size": {
        "w": 1000, 
        "h": 900
    }
}

三、图片高清化接口

3.1 请求示例

地址:
https://api.weixin.qq.com/cv/img/superresolution?img_url=ENCODE_URL&access_token=ACCESS_TOCKEN
示例1:
curl 'https://api.weixin.qq.com/cv/img/superresolution?img_url=ENCODE_URL&access_token=ACCESS_TOCKEN'
示例2:
curl -F 'img=@test.jpg' 'https://api.weixin.qq.com/cv/img/superresolution?access_token=ACCESS_TOCKEN'

说明:

  1. 图片支持使用img参数实时上传,也支持使用img_url参数传送图片地址,由微信后台下载图片进行识别
  2. 文件大小限制:小于2M
  3. 目前支持将图片超分辨率高清化2倍,即生成图片分辨率为原图2倍大小

3.2返回参数样例

{
    "errcode": 0, 
    "errmsg": "ok", 
    "media_id": "6WXsIXkG7lXuDLspD9xfm5dsvHzb0EFl0li6ySxi92ap8Vl3zZoD9DpOyNudeJGB"
}

返回的media_id有效期为3天,期间可以通过“获取临时素材”接口获取图片二进制,示例:

curl "https://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID" -o "output.jpg"

四、图片智能裁剪接口

4.1 请求示例

地址:
http://api.weixin.qq.com/cv/img/aicrop?img_url=ENCODE_URL&access_token=ACCESS_TOCKEN
示例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'
示例3:
curl -F 'img=@test.jpg' 'http://api.weixin.qq.com/cv/img/aicrop?access_token=ACCESS_TOCKEN'

说明:

  1. 图片支持使用img参数实时上传,也支持使用img_url参数传送图片地址,由微信后台下载图片进行识别
  2. 文件大小限制:小于2M
  3. ratios参数为可选,如果为空,则算法自动裁剪最佳宽高比;如果提供多个宽高比,请以英文逗号“,”分隔,最多支持5个宽高比

4.2返回参数样例

{
    "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
    }
}

五、常见错误码

错误码 errmsg 说明
-1 system error 系统错误,请稍后重试
101000 invalid image url 图片URL错误或拉取URL图像错误
101002 invalid image data 图片数据无效