# 图像处理接口文档

# 一、接口介绍

1.1 接口功能

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

1.2 接口限制

内测期间，对于已认证的订阅号、服务号、企业号、小程序，我们提供了 100 次/天的免费额度供开发者使用。

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

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'

说明：

图片支持使用img参数实时上传，也支持使用img_url参数传送图片地址，由微信后台下载图片进行识别
文件大小限制：小于2M
支持条码、二维码、DataMatrix和PDF417的识别。
二维码、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'

说明：

图片支持使用img参数实时上传，也支持使用img_url参数传送图片地址，由微信后台下载图片进行识别
文件大小限制：小于2M
目前支持将图片超分辨率高清化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'

说明：

图片支持使用img参数实时上传，也支持使用img_url参数传送图片地址，由微信后台下载图片进行识别
文件大小限制：小于2M
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	图片数据无效