# Generated by ShowAPI OpenAPI generator
# source: market/2581
# generated-at: 2026-06-25T17:03:56.871Z
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: true
