{ "openapi": "3.0.3", "info": { "title": "达摩院-人脸人体", "description": "为开发者和企业提供高性能的在线API服务，应用于人脸AR、人脸识别和认证、大规模人脸检索、照片管理等各种场景。", "termsOfService": "https://www.showapi.com/helpcenter/view#/4019/2", "version": "1.0.0" }, "servers": [ { "url": "https://route.showapi.com" } ], "paths": { "/2581-28": { "x-pointCode": 28, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "人像素描风格化", "description": "人像素描风格化可以对一张人物图像自动裁剪其头部区域，生成大头照下的素描画效果。阿里原接口订购地址：https://vision.aliyun.com/facebody\n\n\n输入限制\n图片格式：JPG、JPEG、PNG。\n图片大小：小于10M。\n图片像素：大于100×100像素，小于2000×2000像素。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "人物卡通化结果图的URL地址。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2581_28_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "图片URL地址。" }, "ds_id": { "type": "string" } }, "required": [ "ImageURL", "ds_id" ] } } } } } }, "/2581-27": { "x-pointCode": 27, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "人体检测", "description": "人体检测可以检测图像中的所有人体，并返回每个人体的矩形框位置。阿里原接口订购地址：https://vision.aliyun.com/facebody\n\n\n输入限制\n图片格式：JPEG、JPG、PNG、BMP。\n图片大小：图片大小不超过3M。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "Elements": { "type": "array", "items": { "type": "object", "properties": { "Boxes": { "type": "array", "items": { "type": "number" }, "description": "检测框坐标，格式为[left, top, right, bottom]。" }, "Type": { "type": "string", "description": "检测框对应的检测结果类型。仅返回参数值person。" }, "Score": { "type": "number", "description": "检测框的置信度，取值范围为0~1。" } } } }, "Height": { "type": "number", "description": "输入图片的高度。" }, "Width": { "type": "number", "description": "输入图片的宽度。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "fee_num": { "type": "number", "description": "扣费次数" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2581_27_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "图片URL地址。" }, "ds_id": { "type": "string" } }, "required": [ "ImageURL", "ds_id" ] } } } } } }, "/2581-26": { "x-pointCode": 26, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "人脸比对1v1", "description": "基于您输入的两张图片，分别挑选两张图片中的最大人脸进行比较，判断是否为同一人。同时返回这两个人脸的矩形框坐标、比对的置信度，以及不同误识率的置信度阈值。阿里原接口订购地址：https://vision.aliyun.com/experience/detail?tagName=facebody&children=CompareFace\n\n输入限制\n图片格式：JPEG、JPG、PNG、BMP。\n图像大小：图像大小不超过3M。\n图像分辨率：图片大小要求5x5像素以上，人脸的尺寸建议大于64x64像素。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "Confidence": { "type": "number", "description": "两张图片中的最大人脸属于同一个人的置信度，取值范围0~100。如果某张图片中没有人脸，则返回的置信度为0。" }, "RectAList": { "type": "array", "items": { "type": "number" }, "description": "图片1中最大人脸矩形框[left, top, width, height]，例如[106,61,86,112]。如果图片中没有人脸，则返回的矩形框数值均为0。" }, "RectBList": { "type": "array", "items": { "type": "number" }, "description": "图片2中最大人脸矩形框[left, top, width, height]，例如[771, 118, 222, 303]。如果图片中没有人脸，则返回的矩形框数值均为0。" }, "Thresholds": { "type": "array", "items": { "type": "number" }, "description": "误识率在1/1000，1/10000，1/100000的情况下分别对应的置信度阈值。例如[61.0,69.0,75.0]，表示误识率为1/1000的情况下，置信度（Confidence）超过61%就可以认为是同一个人。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2581_26_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURLA": { "type": "string", "description": "图片URL地址。" }, "ImageURLB": { "type": "string", "description": "图片URL地址。" }, "ds_id": { "type": "string" }, "ImageDataA": { "type": "string", "description": "图像A的Base64编码字符串。当与URL方式共存时，URL方式优先。" }, "ImageDataB": { "type": "string", "description": "图像B的Base64编码字符串。当与URL方式共存时，URL方式优先。" }, "QualityScoreThreshold": { "type": "string", "description": "\t\n质量分阈值，对人脸图片进行质量分析判断，得到的质量分小于该阈值则表示人脸图片质量不符合要求，比对失败。取值范围[0.0,100.0]。0.0或空则表示不做质量分判断逻辑。" } }, "required": [ "ds_id" ] } } } } } }, "/2581-25": { "x-pointCode": 25, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "人脸活体检测", "description": "可以检测图片中的活体对象（主要是人脸）来自直接拍摄或者是翻拍。活体判断的前置条件是图像中有人脸。阿里原接口订购地址：https://vision.aliyun.com/experience/detail?tagName=facebody&children=DetectLivingFace\n\n输入限制\n图片格式：PNG、JPG、JPEG、BMP、GIF、WEBP。\n图片大小：图片大小不超过10MB。如您有大图需求，请提工单进行调整。\n图片像素：建议大于256×256，像素过低可能会影响识别效果。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "Elements": { "type": "array", "items": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "对应请求中的图像URL地址。" }, "TaskId": { "type": "string", "description": "该检测任务的ID。" }, "Results": { "type": "array", "items": { "type": "object" } } } } } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2581_25_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "待检测的图像URL地址" }, "ds_id": { "type": "string" } }, "required": [ "ImageURL", "ds_id" ] } } } } } }, "/2581-24": { "x-pointCode": 24, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "视频活体检测", "description": "可以检测输入视频中的人脸来自直接拍摄还是翻拍。当视频中出现多个人脸时，对画面中面积最大的人脸进行判断，需要确保待检测人脸五官清晰可见。阿里原接口订购地址：https://vision.aliyun.com/experience/detail?tagName=facebody&children=DetectVideoLivingFace\n\n输入限制\n视频格式：MP4、AVI。\n视频大小：视频大小要求64×64像素以上，视频长度大于3秒，视频大小不超过30M。其中人脸尺寸建议大于64×64像素。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "Elements": { "type": "array", "items": { "type": "object", "properties": { "Rect": { "type": "array", "items": { "type": "number" }, "description": "检测出的人脸位置。" }, "FaceConfidence": { "type": "number", "description": "人脸的置信度，取值范围为0~1。" }, "LiveConfidence": { "type": "number", "description": "活体的置信度，取值范围为0~1。" } } } } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2581_24_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "VideoUrl": { "type": "string", "description": "输入待检测人脸的视频URL" }, "ds_id": { "type": "string" } }, "required": [ "VideoUrl", "ds_id" ] } } } } } }, "/2581-23": { "x-pointCode": 23, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "人流热度图估计", "description": "人流热度图估计利用热度图对图片中的人数进行估算。阿里原接口订购地址：https://vision.aliyun.com/facebody\n\n\n输入限制\n图片格式：JPG、JPEG、PNG、BMP。\n图片大小：图片大小不超过3M。\n图片分辨率：分辨率要求大于32×32像素，小于4096×4096像素。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "HotMap": { "type": "string", "description": "热度图的URL地址，3600秒有效。" }, "PeopleNumber": { "type": "number", "description": "图片中估计的人数。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2581_23_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "图片URL地址。" }, "ds_id": { "type": "string" }, "IsShow": { "type": "string", "description": "是否返回热度图。\n\ntrue：返回。\nfalse：不返回。" } }, "required": [ "ImageURL", "ds_id" ] } } } } } }, "/2581-22": { "x-pointCode": 22, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "人体结构化属性", "description": "可以检测图片中人体的属性，具体功能包括人体检测以及属性预估。例如：性别，年龄，朝向，帽子，眼镜，包，衣服，颜色等。阿里原接口订购地址：https://vision.aliyun.com/facebody\n\n\n输入限制\n图片格式：JPG、JPEG、PNG、BMP。\n图片像素：大于20×20像素，无上限要求，但是太大可能会下载超时。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "Boxes": { "type": "array", "items": { "type": "object", "properties": { "BottomRightY": { "type": "number", "description": "边框右下角y坐标值。" }, "BottomRightX": { "type": "number", "description": "边框右下角x坐标值。" }, "Score": { "type": "number", "description": "边界框置信度。" }, "TopLeftX": { "type": "number", "description": "边框左上角x坐标值。" }, "TopLeftY": { "type": "number", "description": "边框左上角y坐标值。" } } } }, "Attributes": { "type": "array", "items": { "type": "object", "properties": { "Glasses": { "type": "object", "properties": { "Name": { "type": "string", "description": "Yes（戴眼镜）；No（不戴眼镜）。" }, "Score": { "type": "number", "description": "置信度。" } } }, "Handbag": { "type": "object", "properties": { "Name": { "type": "string", "description": "Yes（有手提包）；No（无手提包）。" }, "Score": { "type": "number", "description": "置信度。" } } }, "Age": { "type": "object", "properties": { "Name": { "type": "string", "description": "AgeOver60（大于60岁）；Age18-60（18-60岁之间）；AgeLess18（小于18岁）。" }, "Score": { "type": "number", "description": "置信度。" } } }, "UpperWear": { "type": "object", "properties": { "Name": { "type": "string", "description": "LongSleeve（长袖）；ShortSleeve（短袖）。" }, "Score": { "type": "number", "description": "置信度。" } } }, "Orient": { "type": "object", "properties": { "Name": { "type": "string", "description": "Front（正向）；Side（侧向）；Back（背面）。" }, "Score": { "type": "number", "description": "置信度。" } } }, "LowerWear": { "type": "object", "properties": { "Name": { "type": "string", "description": "Trousers（长裤）；Shorts（短裤）；Skirt&Dress（裙子）。" }, "Score": { "type": "number", "description": "置信度。" } } }, "Backpack": { "type": "object", "properties": { "Name": { "type": "string", "description": "Yes（有背包）；No（无背包）。" }, "Score": { "type": "number", "description": "置信度。" } } }, "UpperColor": { "type": "object", "properties": { "Name": { "type": "string", "description": "黑，灰，蓝，绿，白，紫，红，棕，黄，粉，不确定。" }, "Score": { "type": "number", "description": "置信度。" } } }, "Gender": { "type": "object", "properties": { "Name": { "type": "string", "description": "male（男）；female（女）。" }, "Score": { "type": "number", "description": "置信度。" } } }, "Hat": { "type": "object", "properties": { "Name": { "type": "string", "description": "Yes（戴帽子）；No（不戴帽子）。" }, "Score": { "type": "number", "description": "置信度。" } } }, "ShoulderBag": { "type": "object", "properties": { "Name": { "type": "string", "description": "Yes（有肩挎包）；No（无肩挎包）。" }, "Score": { "type": "number", "description": "置信度。" } } }, "LowerColor": { "type": "object", "properties": { "Name": { "type": "string", "description": "黑，灰，蓝，绿，白，紫，红，棕，黄，粉，不确定。" }, "Score": { "type": "number", "description": "置信度。" } } } } } }, "PersonNumber": { "type": "number", "description": "检测到的行人个数，取值为正整数。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2581_22_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "图片URL地址。" }, "ds_id": { "type": "string" } }, "required": [ "ImageURL", "ds_id" ] } } } } } }, "/2581-21": { "x-pointCode": 21, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "人体计数", "description": "以检测输入图片中人体的个数。阿里原接口订购地址：https://vision.aliyun.com/facebody\n\n\n输入限制\n图片格式：JPEG、JPG、PNG、BMP。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "PersonNumber": { "type": "number", "description": "人体的个数。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2581_21_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "图片URL地址。" }, "ds_id": { "type": "string" } }, "required": [ "ImageURL", "ds_id" ] } } } } } }, "/2581-20": { "x-pointCode": 20, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "行人区域进入检测", "description": "可以检测图像中的人体。阿里原接口订购地址：https://vision.aliyun.com/facebody\n\n\n输入限制\n图片格式：JPEG、JPG、PNG、BMP。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "Elements": { "type": "array", "items": { "type": "object", "properties": { "Boxes": { "type": "array", "items": { "type": "number" }, "description": "检测框坐标，格式为[left, top, right, bottom]。" }, "Type": { "type": "string", "description": "检测框对应的物体。" }, "Score": { "type": "number", "description": "检测框的置信度，取值范围为0~1。" } } } }, "Height": { "type": "number", "description": "输入图片的高度。" }, "Width": { "type": "number", "description": "输入图片的宽度。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2581_20_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "图片URL地址。" }, "ds_id": { "type": "string" } }, "required": [ "ImageURL", "ds_id" ] } } } } } }, "/2581-19": { "x-pointCode": 19, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "动作行为识别", "description": "可以识别视频和图像中的人体动作行为，并返回识别后的行为类别。当前可以识别的行为类别包括：举手、吃喝、吸烟、打电话、玩手机、趴桌睡觉、跌倒。您可以根据系统提供的动作置信度判断阈值，对识别的动作进行判断。阿里原接口订购地址：https://vision.aliyun.com/facebody\n\n\n输入限制\n视频要求：时长大于2秒；支持一些常见的视频格式，例如MPEG、AVI、MOV、MP4。\n说明： 建议为居家摄像头或近距离监控场景。即摄像头固定不动，拍摄距离为2~10米之间。\n图像要求：为2秒视频均匀采样的4张图像。支持的格式为JPEG、PNG、BMP、JPG。\n分辨率：图像和视频的分辨率都要求为大于256×256像素，小于5000×5000像素。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "Elements": { "type": "array", "items": { "type": "object", "properties": { "Boxes": { "type": "array", "items": { "type": "string" }, "description": "具体动作的坐标框列表。" }, "Labels": { "type": "array", "items": { "type": "string" }, "description": "识别到的行为类别。" }, "Scores": { "type": "array", "items": { "type": "string" }, "description": "行为类别的置信度。取值范围0~1，值越大，识别到的动作越准确。系统根据算法，为不同的动作给出判断的阈值标准，您也可以根据自己的实际情况，对判断的阈值标准进行调整。\n\n举手：0.41（低于0.41则认为不是举手行为，否则认为是举手行为。）\n吃喝：0.55（低于0.55则认为不是吃喝行为，否则认为是吃喝行为。）\n吸烟：0.53（低于0.53则认为不是吸烟行为，否则认为是吸烟行为。）\n打电话：0.48（低于0.48则认为不是打电话行为，否则认为是打电话行为。）\n玩手机：0.58（低于0.58则认为不是玩手机行为，否则认为是玩手机行为。）\n趴桌睡觉：0.55（低于0.55则认为不是趴桌睡觉行为，否则认为是趴桌睡觉行为。）\n跌倒：0.46（低于0.46则认为不是跌倒行为，否则认为是跌倒行为。）" }, "Timestamp": { "type": "number", "description": "当前行为在视频或者图像中发生的时间戳信息。" } } } } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2581_19_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "Type": { "type": "string", "description": "输入内容类型，包括视频和图像两种类型。\n\n0：表示输入视频。\n1：表示输入图像。" }, "VideoUrl": { "type": "string", "description": "Type为0时需要输入的视频URL地址。" }, "URL": { "type": "string", "description": "Type为1时需要输入的图像URL地址，必须输入4张图像，且4张图像必须为两秒钟视频均匀采样的图像。" }, "ds_id": { "type": "string" } }, "required": [ "Type", "ds_id" ] } } } } } }, "/2581-18": { "x-pointCode": 18, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "手势关键点检测", "description": "可以获取手势的二十一个关键点信息。阿里原接口订购地址：https://vision.aliyun.com/facebody\n\n\n输入限制\n图片格式：JPEG、JPG、BMP、PNG。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "Outputs": { "type": "array", "items": { "type": "object", "properties": { "Results": { "type": "array", "items": { "type": "object", "properties": { "Hands": { "type": "object", "properties": { "KeyPoints": { "type": "array", "items": { "type": "object", "properties": { "Label": { "type": "string", "description": "关键点的标签。" }, "Positions": { "type": "array", "items": { "type": "object", "properties": { "Points": { "type": "array", "items": { "type": "number" }, "description": "关键点的坐标，x和y的取值范围为0~1。相对于图像宽度width和图像高度height的相对坐标，实际坐标为x*width和y*height。" } } } } } } }, "Confident": { "type": "number", "description": "手势关键点的置信度。" } }, "description": "手势关键点信息。" }, "Box": { "type": "object", "properties": { "Confident": { "type": "number", "description": "手势检测框的置信度。" }, "Positions": { "type": "array", "items": { "type": "object", "properties": { "Points": { "type": "array", "items": { "type": "number" }, "description": "手体检测框的坐标，x和y的取值范围为0~1。相对于图像宽度width和图像高度height的相对坐标，实际坐标为x*width和y*height。" } } } } }, "description": "手势的检测框信息。" } } } }, "HandCount": { "type": "number", "description": "手掌的个数。" } } } }, "MetaObject": { "type": "object", "properties": { "Height": { "type": "number", "description": "图片高度。" }, "Width": { "type": "number", "description": "图片宽度。" } } } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2581_18_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "图片URL地址。" }, "ds_id": { "type": "string" } }, "required": [ "ImageURL", "ds_id" ] } } } } } }, "/2581-17": { "x-pointCode": 17, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "人体姿态关键点", "description": "以获取人体的十八个关键点信息。包括：nose、neck、right_shoudler、right_elbow、right_wrist、left_shoudler、left_elbow、left_wrist、right_hip、right_knee、right_ankle、left_hip、left_knee、left_ankle、right_eye、left_eye、right_ear、left_ear。阿里原接口订购地址：https://vision.aliyun.com/facebody\n\n\n输入限制\n图片格式：JPEG、JPG、BMP、PNG。\n图片URL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "Outputs": { "type": "array", "items": { "type": "object", "properties": { "HumanCount": { "type": "number", "description": "人体的个数。" }, "Results": { "type": "array", "items": { "type": "object", "properties": { "Bodies": { "type": "array", "items": { "type": "object", "properties": { "Confident": { "type": "number", "description": "关键点置信度。" }, "Label": { "type": "string", "description": "关键点的标签。包括如下类型：nose、neck、right_shoudler、right_elbow、right_wrist、left_shoudler、left_elbow、left_wrist、right_hip、right_knee、right_ankle、left_hip、left_knee、left_ankle、right_eye、left_eye、right_ear、left_ear。" }, "Positions": { "type": "array", "items": { "type": "object", "properties": { "Points": { "type": "array", "items": { "type": "number" }, "description": "关键点x坐标，取值范围0~1。相对于图像宽度width的相对坐标，实际坐标为x*width。" } } } } } } } } } } } } }, "MetaObject": { "type": "object", "properties": { "Height": { "type": "number", "description": "图片高度。" }, "Width": { "type": "number", "description": "图片宽度。" } } } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2581_17_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "图片URL地址。" }, "ds_id": { "type": "string" } }, "required": [ "ImageURL", "ds_id" ] } } } } } }, "/2581-16": { "x-pointCode": 16, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "人物动漫化", "description": "人物动漫化可以将一张人物图像进行转换处理，生成二次元卡通形象，并返回卡通化后的结果图像。阿里原接口订购地址：https://vision.aliyun.com/facebody\n\n\n输入限制\n图片格式：JPG、JPEG、PNG。\n图片大小：大小不超过10M。\n图片分辨率：分辨率要求大于32×32像素，小于2000×2000像素。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "人物卡通化结果图的URL地址。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2581_16_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "图片URL地址。" }, "ds_id": { "type": "string" }, "AlgoType": { "type": "string", "description": "卡通效果配置参数。取值如下：\n\nanime：日漫风\n3d：3D特效\nhanddrawn：手绘风\nsketch：铅笔画\nartstyle：艺术特效" } }, "required": [ "ImageURL", "ds_id" ] } } } } } }, "/2581-15": { "x-pointCode": 15, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "人脸信息脱敏", "description": "对输入图像中的人脸进行模糊处理，输出脱敏后的图像。阿里原接口订购地址：https://vision.aliyun.com/facebody\n\n\n输入限制\n图片格式：JPEG、JPG、PNG、BMP。\n图像大小：图像大小不超过3M。\n图像分辨率：图片分辨率要求大于32x32像素，小于5000×5000像素。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "脱敏后的图片URL地址。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2581_15_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "图片URL地址。当前仅支持上海地域的OSS链接，如何生成URL请参见生成URL。" }, "ds_id": { "type": "string" } }, "required": [ "ImageURL", "ds_id" ] } } } } } }, "/2581-13": { "x-pointCode": 13, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "人脸美型", "description": "可以对人脸的轮廓和五官进行调整。 您也可以通过手动调整美型强度，进一步对人脸进行精细化调整。阿里原接口订购地址：https://vision.aliyun.com/facebody\n\n\n输入限制\n图片格式：JPEG、JPG、BMP、PNG。\n图片分辨率：图片分辨率最大不超过2000×2000像素。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "人脸美型结果图片URL地址。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2581_13_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "图片URL地址。当前仅支持上海地域的OSS链接，如何生成URL请参见生成URL。" }, "ds_id": { "type": "string" }, "ShapeType": { "type": "string", "description": "表示美型部位，包括：0（颧骨）、1（削脸）、2（瘦脸）、3（脸长）、4（下巴缩短）、5（下巴拉长）、6（瘦下巴）、7（瘦下颌）、8（大眼）、9（眼角1）、10（眼距）、11（拉宽眼距）、12（眼角2）、13（眼睛高度）、14（瘦鼻）、15（鼻翼）、16（鼻长）、17（鼻头长）、18（唇宽）、19（嘴唇大小）、20（唇高）、21（人中）。" }, "Strength": { "type": "string", "description": "美型强度，取值范围0~1。" } }, "required": [ "ImageURL", "ds_id", "ShapeType", "Strength" ] } } } } } }, "/2581-12": { "x-pointCode": 12, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "人脸美妆", "description": "可以模拟彩妆，通过添加彩妆素材，进一步提升人脸美化效果。阿里原接口订购地址：https://vision.aliyun.com/facebody\n\n\n输入限制\n图片分辨率：图片分辨率最大不超过2000×2000像素，建议为1080×1920像素。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "人脸美妆结果图像的URL地址。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2581_12_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "图片URL地址。当前仅支持上海地域的OSS链接，如何生成URL请参见生成URL。" }, "ds_id": { "type": "string" }, "ResourceType": { "type": "string", "description": "美妆使用的风格，具体包括：0（whole）、1（基础妆）、2（少女妆）、3（活力妆）、4（优雅妆）、5（魅惑妆）、6（梅子妆）。" }, "Strength": { "type": "string", "description": "美妆强度，取值范围0～1。" }, "MakeupType": { "type": "string", "description": "美妆类型，当前支持whole（整妆）。" } }, "required": [ "ImageURL", "ds_id", "ResourceType", "Strength", "MakeupType" ] } } } } } }, "/2581-11": { "x-pointCode": 11, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "人脸滤镜", "description": "可以对图片的整体风格进行转变。阿里原接口订购地址：https://vision.aliyun.com/facebody\n\n\n输入限制\n图片分辨率：图片分辨率最大不超过2000×2000像素。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "输出转换风格后的图片URL地址。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2581_11_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "图片URL地址。当前仅支持上海地域的OSS链接，如何生成URL请参见生成URL。" }, "ds_id": { "type": "string" }, "ResourceType": { "type": "string", "description": "选择图片风格，包括：默认、向日葵、桔梗、垦丁、大理、丽江。" }, "Strength": { "type": "string", "description": "滤镜强度，取值范围0~1。" } }, "required": [ "ImageURL", "ds_id", "ResourceType", "Strength" ] } } } } } }, "/2581-10": { "x-pointCode": 10, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "人脸修复增强", "description": "可以对输入图像中的人脸进行裁剪、对齐、细节增强，最后再融合回原图。阿里原接口订购地址：https://vision.aliyun.com/facebody\n\n\n输入限制\n图片格式：JPEG、JPG、BMP、PNG。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "人脸修复增强后的结果图URL地址。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2581_10_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "图片URL地址。当前仅支持上海地域的OSS链接，如何生成URL请参见生成URL。" }, "ds_id": { "type": "string" } }, "required": [ "ImageURL", "ds_id" ] } } } } } }, "/2581-9": { "x-pointCode": 9, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "人脸美颜", "description": "可以对图像中的人脸进行美颜，包括磨皮、美白、去除黑眼圈、法令纹等。阿里原接口订购地址：https://vision.aliyun.com/facebody\n\n输入限制\n图片分辨率：图片分辨率最大不超过2000×2000像素。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "美颜后图像的URL地址。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2581_9_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "图片URL地址。当前仅支持上海地域的OSS链接，如何生成URL请参见生成URL。" }, "ds_id": { "type": "string" }, "Sharp": { "type": "string", "description": "锐化（清晰度）程度，取值范围0~1。越接近1锐化程度越高。" }, "Smooth": { "type": "string", "description": "平滑程度，取值范围0~1。越接近1平滑程度越高。" }, "White": { "type": "string", "description": "美白程度，取值范围0~1。越接近1美白程度越高。" } }, "required": [ "ImageURL", "ds_id", "Sharp", "Smooth", "White" ] } } } } } }, "/2581-8": { "x-pointCode": 8, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "口罩人脸比对", "description": "接口用于检测两张人脸（图像中人脸可能带口罩）是否属于同一个人脸。阿里原接口订购地址：https://vision.aliyun.com/experience/detail?tagName=facebody&children=VerifyFaceMask\n\n输入限制\n图片格式：JPEG、JPG、BMP、PNG。\n图片大小：大小不超过3M。\n图片分辨率：图片最小要求5×5像素，图片中人脸建议大于64×64像素。\nURL地址中不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "Confidence": { "type": "number", "description": "两种图片中人脸为同一个人的置信度。取值范围0~100。" }, "MaskRef": { "type": "number", "description": "图像2中的人脸是否带口罩。取值如下：\n\n0：非人脸。\n1：没戴口罩。\n2：正确戴口罩。\n3：错误戴口罩。" }, "Rectangle": { "type": "array", "items": { "type": "number" }, "description": "图像1的人脸检测框。格式为[left, top, right, bottom]。" }, "Thresholds": { "type": "array", "items": { "type": "number" }, "description": "误识率在10e-3，10e-4，10e-5时对应的置信度分类阈值。" }, "RectangleRef": { "type": "array", "items": { "type": "number" }, "description": "图像2的人脸检测框。格式为[left, top, right, bottom]。" }, "Mask": { "type": "number", "description": "图像1中的人脸是否带口罩。取值如下：\n\n0：非人脸。\n1：没戴口罩。\n2：正确戴口罩。\n3：错误戴口罩。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2581_8_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "待检测的图片URL地址。" }, "ds_id": { "type": "string" }, "RefUrl": { "type": "string", "description": "待检测的图片URL地址。" } }, "required": [ "ImageURL", "ds_id" ] } } } } } }, "/2581-7": { "x-pointCode": 7, "x-mode": "mapping", "x-read-timeout": 5, "x-connect-timeout": 5, "post": { "summary": "明星识别", "description": "可以识别图像中的明星人物。可以识别超过2.7万个明星人物。阿里原接口订购地址：https://vision.aliyun.com/experience/detail?tagName=facebody&children=DetectCelebrity\n\n输入限制\n图片格式：JPEG、JPG、PNG。\nURL地址不能包含中文字符。", "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ShowapiResEnvelope" }, { "type": "object", "properties": { "showapi_res_body": { "type": "object", "properties": { "Data": { "type": "object", "properties": { "FaceRecognizeResults": { "type": "array", "items": { "type": "object", "properties": { "Name": { "type": "string", "description": "识别出的人物名称。" }, "FaceBoxes": { "type": "array", "items": { "type": "number" }, "description": "人脸框坐标信息。格式为[x，y，width，height]。x和y为人脸框的左上角坐标，width和height为人脸框的宽和高。x、y、width和height四个值均为人脸框与输入图像宽和高的等比值。" } } } }, "Height": { "type": "number", "description": "图片高度。" }, "Width": { "type": "number", "description": "图片宽度。" } } }, "ret_code": { "type": "number" }, "remark": { "type": "string" }, "RequestId": { "type": "string" } }, "description": "业务返回体" } } } ] } } } } }, "operationId": "2581_7_POST", "parameters": [], "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "ImageURL": { "type": "string", "description": "待检测的图像URL地址。" }, "ds_id": { "type": "string" } }, "required": [ "ImageURL", "ds_id" ] } } } } } } }, "components": { "securitySchemes": { "AppKeyAuth": { "type": "apiKey", "in": "query", "name": "appKey", "description": "从 ShowAPI 控制台获取的 appKey，管理地址：https://www.showapi.com/console#/myApp" } }, "schemas": { "ShowapiResEnvelope": { "type": "object", "description": "ShowAPI 统一返回包裹（业务数据位于 showapi_res_body）", "properties": { "showapi_res_code": { "type": "integer", "description": "API 返回的状态码" }, "showapi_res_error": { "type": "string", "description": "API 返回的错误信息" }, "showapi_res_id": { "type": "string", "description": "API 请求的唯一标识" }, "showapi_fee_num": { "type": "integer", "description": "API 调用计费次数" } } } } }, "security": [ { "AppKeyAuth": [] } ], "externalDocs": { "url": "https://www.showapi.com/apiGateway/view/2581?tab=book" }, "x-apiCode": "2581", "x-is-own": false, "x-is-op": true }