猿圈API可以通过申请获得appid和secret,在浏览器中实现完整的开发环境,为你的产品提供最专业的在线编译和技术测评功能。

请求格式

POST方式调用

注意:Content-Type为application/x-www-form-urlencoded,然后通过urlencode格式化请求体。

返回格式

JSON格式

请求限制

请求图片需经过base64编码及urlencode后传入:图片的base64编码指将一副图片数据编码成一串字符串,使用该字符串代替图像地址。

覆盖多种通用场景、多种语言的高精度整图文字检测和识别服务,包括各类印刷和手写文档、网络图片、表格、数字等;可用于纸质文档电子化、办公文档/报表识别、图像内容审核等场景。并对考试场景进行了优化,特别适合于考试场景中对特定的内容、网址等进行识别,以监测考生在考试过程中访问禁止的网站和内容。

请求示例

请求URL:https://open-api.oxcoder.com.cn/v1/ocr

HTTP方法:POST

Header如下:

参数
Content-Type application/x-www-form-urlencoded

请求参数

参数 必选 类型 说明
image string 图像数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M,最短边至少15px,最长边最大4096px,支持 jpg/jpeg/png/bmp 格式

返回数据结构

参数 必选 类型 说明
elapse_time string 用时
success boolean 识别状态
words_result array[] 识别结果数组

返回示例:

Copy
{
    "elapse_time": "0.09283304214477539",
    "success": true,
    "words_result": [
        {
            "word": "猿圈"
        },
        {
            "word": "让考试更有“AI”"
        }
    ]
}
    

经过大量考试数据训练后的人脸识别算法,能迅速通过表情、头部姿态等识别可疑的作弊行为。

请求示例

请求URL:https://open-api.oxcoder.com.cn/v1/face_detect

HTTP方法:POST

Header如下:

参数
Content-Type application/x-www-form-urlencoded

请求参数

参数 必选 类型 说明
image string 图像数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M,最短边至少15px,最长边最大4096px,支持 jpg/jpeg/png/bmp 格式

返回数据结构

参数 必选 类型 说明
elapse_time string 用时
success boolean 识别状态
face_list array[] 识别结果数组
+angle array 人脸旋转角度参数
++pitch double 三维旋转之俯仰角度[-90(上), 90(下)]
++roll double 平面内旋转角[-180(逆时针), 180(顺时针)]
++yaw double 三维旋转之左右旋转角[-90(左), 90(右)]
+beauty int64 颜值,范围0-100,越大表示越美。当face_fields包含beauty时返回
+emotion array 情绪 face_field包含emotion时返回
++type string angry:愤怒 disgust:厌恶 fear:恐惧 happy:高兴 sad:伤心 surprise:惊讶 neutral:无表情 pouty: 撅嘴 grimace:鬼脸
+location array 人脸在图片中的位置
++height double 人脸区域的高度
++left double 人脸区域离左边界的距离
++top double 人脸区域离上边界的距离
width double 人脸区域的宽度
face_num int 检测到的图片中的人脸数量

返回示例:

Copy
{
    "elapse_time": "0.2710535526275635",
     "face_list": [
         {
            "angle": {
                "pitch": -13.256460225515493,
                "roll": -4.979691017031571,
                 "yaw": 20.166090912070104
            },
            "beauty": 51.07346057891846,
            "emotion": {
                "type": "fear"
            },
            "location": {
                "height": 129,
                "left": 196,
                "top": 39,
                "width": 129
            }
        }
    ],
    "face_num": 1,
    "success": true
 }
    

检测图像中的人体并返回人体矩形框位置,精准定位21个核心关键点,21个关键点的位置:头顶、左耳、右耳、左眼、右眼、鼻子、左嘴角、右嘴角、脖子、左肩、右肩、左手肘、右手肘、左手腕、右手腕、左髋部、右髋部、左膝、右膝、左脚踝、右脚踝,并在此基础上,经过大量考试数据训练后的人体姿态优化算法,能快速通过异常姿态识别可疑的作弊动作。

请求示例

请求URL:https://open-api.oxcoder.com.cn/v1/keypoints

HTTP方法:POST

Header如下:

参数
Content-Type application/x-www-form-urlencoded

请求参数

参数 必选 类型 说明
image string 图像数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M,最短边至少15px,最长边最大4096px,支持 jpg/jpeg/png/bmp 格式

返回数据结构

参数 必选 类型 说明
elapse_time string 用时
success boolean 识别状态
person_num uint32 人体数目
person_info array[] 识别结果数组,人体姿态信息
location object 人体在图片中的坐标信息
height float 人体区域的高度
left float 人体区域离左边界的距离
score float 人体框的概率分数,取值0-1,得分越接近1表示识别准确的概率越大
top float 人体区域离上边界的距离
width float 人体区域的宽度
body_parts object 身体部位关键点信息
left_ankle object 左脚踝
left_ear object 左耳
left_elbow object 左手肘
left_eye object 左眼
left_hip object 左髋部
left_knee object 左膝
left_mouth_corner object 左嘴角
left_shoulder object 左肩
left_wrist object 左手腕
neck object 颈部
nose object 左手腕
right_ankle object 右脚踝
right_ear object 右耳
right_elbow object 右手肘
right_eye object 右眼
right_hip object 右髋部
right_knee object 右膝
right_mouth_corner object 右嘴角
right_shoulder object 右肩
right_wrist object 右手腕
top_head object 头顶

返回示例:

Copy

                            {
                                "elapse_time": "0.5075685977935791",
                                "person_info": [
                                    {
                                        "body_parts": {
                                            "left_ankle": {
                                                "score": 0.801051139831543,
                                                "x": 728.6331176757812,
                                                "y": 877.114013671875
                                            },
                                            "left_ear": {
                                                "score": 0.8627427220344543,
                                                "x": 657.3009033203125,
                                                "y": 286.05731201171875
                                            },
                                            "left_elbow": {
                                                "score": 0.7265492081642151,
                                                "x": 782.81640625,
                                                "y": 363.17840576171875
                                            },
                                            "left_eye": {
                                                "score": 0.8714839220046997,
                                                "x": 642.9151611328125,
                                                "y": 280.30792236328125
                                            },
                                            "left_hip": {
                                                "score": 0.6956472992897034,
                                                "x": 685.8357543945312,
                                                "y": 580.0787963867188
                                            },
                                            "left_knee": {
                                                "score": 0.7738330364227295,
                                                "x": 705.8043823242188,
                                                "y": 740.038818359375
                                            },
                                            "left_mouth_corner": {
                                                "score": 0.8350763916969299,
                                                "x": 611.8358154296875,
                                                "y": 309.72698974609375
                                            },
                                            "left_shoulder": {
                                                "score": 0.8173873424530029,
                                                "x": 697.2603149414062,
                                                "y": 345.98980712890625
                                            },
                                            "left_wrist": {
                                                "score": 0.856551468372345,
                                                "x": 882.8404541015625,
                                                "y": 377.29217529296875
                                            },
                                            "neck": {
                                                "score": 0.9209074974060059,
                                                "x": 628.6690063476562,
                                                "y": 351.5884704589844
                                            },
                                            "nose": {
                                                "score": 0.9341371655464172,
                                                "x": 625.8992309570312,
                                                "y": 288.86004638671875
                                            },
                                            "right_ankle": {
                                                "score": 0.8265672326087952,
                                                "x": 582.9627685546875,
                                                "y": 891.4306030273438
                                            },
                                            "right_ear": {
                                                "score": 0.8524975180625916,
                                                "x": 588.7706909179688,
                                                "y": 285.9697265625
                                            },
                                            "right_elbow": {
                                                "score": 0.8071341514587402,
                                                "x": 468.7079772949219,
                                                "y": 354.6374206542969
                                            },
                                            "right_eye": {
                                                "score": 0.8849624991416931,
                                                "x": 608.7929077148438,
                                                "y": 280.2781677246094
                                            },
                                            "right_hip": {
                                                "score": 0.6906991600990295,
                                                "x": 591.6254272460938,
                                                "y": 580.2304077148438
                                            },
                                            "right_knee": {
                                                "score": 0.8202379941940308,
                                                "x": 582.9716186523438,
                                                "y": 751.4851684570312
                                            },
                                            "right_mouth_corner": {
                                                "score": 0.9225035905838013,
                                                "x": 637.2936401367188,
                                                "y": 309.72698974609375
                                            },
                                            "right_shoulder": {
                                                "score": 0.8452157974243164,
                                                "x": 557.3289184570312,
                                                "y": 351.76519775390625
                                            },
                                            "right_wrist": {
                                                "score": 0.8521012663841248,
                                                "x": 357.5320129394531,
                                                "y": 354.4705810546875
                                            },
                                            "top_head": {
                                                "score": 0.7922987937927246,
                                                "x": 619.1094970703125,
                                                "y": 272.6973571777344
                                            }
                                        },
                                        "location": {
                                            "height": 639.6029968261719,
                                            "left": 357.5320129394531,
                                            "score": 0.8077768683433533,
                                            "top": 280.2781677246094,
                                            "width": 525.3084411621094
                                        }
                                    }
                                ],
                                "person_num": 1,
                                "success": true
                            }