基本规范
猿圈API可以通过申请获得appid和secret，在浏览器中实现完整的开发环境，为你的产品提供最专业的在线编译和技术测评功能。
请求格式
POST方式调用
注意：Content-Type为application/x-www-form-urlencoded，然后通过urlencode格式化请求体。
返回格式
JSON格式
请求限制
请求图片需经过base64编码及urlencode后传入：图片的base64编码指将一副图片数据编码成一串字符串，使用该字符串代替图像地址。
考试关键内容识别 (OCR)
覆盖多种通用场景、多种语言的高精度整图文字检测和识别服务，包括各类印刷和手写文档、网络图片、表格、数字等；可用于纸质文档电子化、办公文档/报表识别、图像内容审核等场景。并对考试场景进行了优化，特别适合于考试场景中对特定的内容、网址等进行识别，以监测考生在考试过程中访问禁止的网站和内容。
请求示例
请求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
}