# Generated by ShowAPI OpenAPI generator # source: market/2581 # generated-at: 2026-07-25T18:01:37.447Z 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 输入限制 图片格式：JPG、JPEG、PNG。 图片大小：小于10M。 图片像素：大于100×100像素，小于2000×2000像素。 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: 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 输入限制 图片格式：JPEG、JPG、PNG、BMP。 图片大小：图片大小不超过3M。 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: 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 输入限制 图片格式：JPEG、JPG、PNG、BMP。 图像大小：图像大小不超过3M。 图像分辨率：图片大小要求5x5像素以上，人脸的尺寸建议大于64x64像素。 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: 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: |- 质量分阈值，对人脸图片进行质量分析判断，得到的质量分小于该阈值则表示人脸图片质量不符合要求，比对失败。取值范围[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 输入限制 图片格式：PNG、JPG、JPEG、BMP、GIF、WEBP。 图片大小：图片大小不超过10MB。如您有大图需求，请提工单进行调整。 图片像素：建议大于256×256，像素过低可能会影响识别效果。 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: 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 输入限制 视频格式：MP4、AVI。 视频大小：视频大小要求64×64像素以上，视频长度大于3秒，视频大小不超过30M。其中人脸尺寸建议大于64×64像素。 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: 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 输入限制 图片格式：JPG、JPEG、PNG、BMP。 图片大小：图片大小不超过3M。 图片分辨率：分辨率要求大于32×32像素，小于4096×4096像素。 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: 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: |- 是否返回热度图。 true：返回。 false：不返回。 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 输入限制 图片格式：JPG、JPEG、PNG、BMP。 图片像素：大于20×20像素，无上限要求，但是太大可能会下载超时。 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: 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 输入限制 图片格式：JPEG、JPG、PNG、BMP。 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: 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 输入限制 图片格式：JPEG、JPG、PNG、BMP。 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: 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 输入限制 视频要求：时长大于2秒；支持一些常见的视频格式，例如MPEG、AVI、MOV、MP4。 说明： 建议为居家摄像头或近距离监控场景。即摄像头固定不动，拍摄距离为2~10米之间。 图像要求：为2秒视频均匀采样的4张图像。支持的格式为JPEG、PNG、BMP、JPG。 分辨率：图像和视频的分辨率都要求为大于256×256像素，小于5000×5000像素。 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: 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，值越大，识别到的动作越准确。系统根据算法，为不同的动作给出判断的阈值标准，您也可以根据自己的实际情况，对判断的阈值标准进行调整。 举手：0.41（低于0.41则认为不是举手行为，否则认为是举手行为。） 吃喝：0.55（低于0.55则认为不是吃喝行为，否则认为是吃喝行为。） 吸烟：0.53（低于0.53则认为不是吸烟行为，否则认为是吸烟行为。） 打电话：0.48（低于0.48则认为不是打电话行为，否则认为是打电话行为。） 玩手机：0.58（低于0.58则认为不是玩手机行为，否则认为是玩手机行为。） 趴桌睡觉：0.55（低于0.55则认为不是趴桌睡觉行为，否则认为是趴桌睡觉行为。） 跌倒：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: |- 输入内容类型，包括视频和图像两种类型。 0：表示输入视频。 1：表示输入图像。 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 输入限制 图片格式：JPEG、JPG、BMP、PNG。 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: 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 输入限制 图片格式：JPEG、JPG、BMP、PNG。 图片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 输入限制 图片格式：JPG、JPEG、PNG。 图片大小：大小不超过10M。 图片分辨率：分辨率要求大于32×32像素，小于2000×2000像素。 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: 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: |- 卡通效果配置参数。取值如下： anime：日漫风 3d：3D特效 handdrawn：手绘风 sketch：铅笔画 artstyle：艺术特效 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 输入限制 图片格式：JPEG、JPG、PNG、BMP。 图像大小：图像大小不超过3M。 图像分辨率：图片分辨率要求大于32x32像素，小于5000×5000像素。 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: 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 输入限制 图片格式：JPEG、JPG、BMP、PNG。 图片分辨率：图片分辨率最大不超过2000×2000像素。 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: 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 输入限制 图片分辨率：图片分辨率最大不超过2000×2000像素，建议为1080×1920像素。 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: 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 输入限制 图片分辨率：图片分辨率最大不超过2000×2000像素。 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: 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 输入限制 图片格式：JPEG、JPG、BMP、PNG。 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: 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 输入限制 图片分辨率：图片分辨率最大不超过2000×2000像素。 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: 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 输入限制 图片格式：JPEG、JPG、BMP、PNG。 图片大小：大小不超过3M。 图片分辨率：图片最小要求5×5像素，图片中人脸建议大于64×64像素。 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: Confidence: type: number description: 两种图片中人脸为同一个人的置信度。取值范围0~100。 MaskRef: type: number description: |- 图像2中的人脸是否带口罩。取值如下： 0：非人脸。 1：没戴口罩。 2：正确戴口罩。 3：错误戴口罩。 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中的人脸是否带口罩。取值如下： 0：非人脸。 1：没戴口罩。 2：正确戴口罩。 3：错误戴口罩。 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 输入限制 图片格式：JPEG、JPG、PNG。 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: 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: false