# Generated by ShowAPI OpenAPI generator
# source: market/2571
# generated-at: 2026-07-26T06:54:22.259Z
openapi: 3.0.3
info:
  title: 百度云-人体分析
  description: |-
    体相关信息，提供人体检测与追踪、关键点定位、人流量统计、属性识别、行为分析、人像分割、手势识别、指尖检测等能力。支持本地服务器或专有云服务器私有化部署，保障业务数据的私密性和安全性
    准确识别图像中的人体相关信息。
  termsOfService: https://www.showapi.com/helpcenter/view#/4019/2
  version: 1.0.0
servers:
  - url: https://route.showapi.com
paths:
  /2571-9:
    x-pointCode: 9
    x-mode: mapping
    x-read-timeout: 30
    x-connect-timeout: 30
    post:
      summary: 人流量统计-动态版
      description: 统计图像中的人体个数和流动趋势，以头肩为主要识别目标统计人数，无需正脸、全身照，适应人群密集、各种出入口场景。原接口订购地址：https://cloud.baidu.com/product/body
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          person_num:
                            type: number
                            description: 检测到的人体框数目
                          person_info:
                            type: array
                            items:
                              type: string
                            description: 每个框的具体信息
                          person_count:
                            type: object
                            properties:
                              in:
                                type: number
                                description: 当前帧进入区域的瞬时人数，一般情况下，当人体头肩检测框刚好完全进入area区域框时，该画面帧的in计数1；如要计算某一段时间内进入区域的累计人数，可基于连续帧图片的返回结果计算得到
                              out:
                                type: number
                                description: 当前帧进入区域的瞬时人数，一般情况下，当人体头肩检测框刚好完全离开area区域框时，该画面帧的out计数1；如要计算某一段时间内进入区域的累计人数，可基于连续帧图片的返回结果计算得到
                            description: 进出区域的人流统计
                        description: 业务返回体
      operationId: 2571_9_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ds_id:
                  type: string
                  description: 数据源
                dynamic:
                  type: string
                  description: |-
                    true：动态人流量统计，返回总人数、跟踪ID、区域进出人数； 
                    false：静态人数统计，返回总人数
                case_id:
                  type: number
                  description: |-
                    任务ID（通过case_id区分不同视频流，自拟，不同序列间不可重复即可）
                    当dynamic为true时，必填
                case_init:
                  type: string
                  description: |-
                    每个case的初始化信号，为true时对该case下的跟踪算法进行初始化，
                    为false时重载该case的跟踪状态。
                    当为false且读取不到相应case的信息时，直接重新初始化
                    当dynamic为true时，必填
                image:
                  type: string
                  minLength: 0
                  maxLength: 10000000
                  description: |-
                    图像数据，base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M。
                    图片的base64编码是不包含图片头的，如(data:image/jpg;base64,)，支持图片格式：jpg、bmp、png，最短边至少50px，最长边最大4096px。
                show:
                  type: string
                  description: |-
                    是否返回结果图（含统计值和跟踪框渲染），默认不返回，
                    选true时返回渲染后的图片(base64)，其它无效值或为空则默认false
                area:
                  type: string
                  description: |-
                    当dynamic为true时，必填
                    静态人数统计时，只统计区域内的人，缺省时为全图统计。 
                    动态人流量统计时，进出区域的人流会被统计。 逗号分隔，如‘x1,y1,x2,y2,x3,y3...xn,yn'，按顺序依次给出每个顶点的xy坐标（默认尾点和首点相连），形成闭合多边形区域。 服务会做范围（顶点左边需在图像范围内）及个数校验（数组长度必须为偶数，且大于3个顶点）。
                    只支持单个多边形区域，建议设置矩形框，即4个顶点。
                    坐标取值不能超过图像宽度和高度，比如1280的宽度，坐标值最小建议从1开始，最大到1279。
              required:
                - ds_id
                - dynamic
                - image
  /2571-8:
    x-pointCode: 8
    x-mode: mapping
    x-read-timeout: 30
    x-connect-timeout: 30
    post:
      summary: 手部关键点识别
      description: 针对5S内的监控视频片段，识别常见危险行为，如摔倒、砸东西、拉扯、推搡、踢踹等，目前支持单人、双人场景，更多场景和行为持续扩展中。原接口订购地址：https://cloud.baidu.com/product/body
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          log_id:
                            type: string
                          hand_num:
                            type: number
                          hand_info:
                            type: array
                            items:
                              type: object
                              properties:
                                hand_parts:
                                  type: object
                                  properties:
                                    "0":
                                      type: object
                                      properties:
                                        y:
                                          type: number
                                        x:
                                          type: number
                                        score:
                                          type: number
                                location:
                                  type: object
                                  properties:
                                    height:
                                      type: number
                                    width:
                                      type: number
                                    top:
                                      type: number
                                    score:
                                      type: number
                                    left:
                                      type: number
                        description: 业务返回体
      operationId: 2571_8_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ds_id:
                  type: string
                  description: 数据源
                image:
                  type: string
                  minLength: 0
                  maxLength: 10000000
                  description: 图像数据，base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M。图片的base64编码是不包含图片头的，如(data:image/jpg;base64,)，支持图片格式：jpg、bmp、png，最短边至少50px，最长边最大4096px。
              required:
                - ds_id
                - image
  /2571-6:
    x-pointCode: 6
    x-mode: mapping
    x-read-timeout: 30
    x-connect-timeout: 30
    post:
      summary: 驾驶行为分析
      description: 针对车载场景，识别驾驶员使用手机、抽烟、不系安全带、未佩戴口罩、闭眼、打哈欠、双手离开方向盘等动作姿态，分析预警危险驾驶行为，提升行车安全性。原接口订购地址：https://cloud.baidu.com/product/body
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          person_num:
                            type: number
                            description: 识别出的驾驶员检测框数目，0或者1，0代表未监测到驾驶员
                          person_info:
                            type: array
                            items:
                              type: object
                              properties:
                                "0":
                                  type: object
                                  properties:
                                    attributes:
                                      type: object
                                      properties:
                                        cellphone:
                                          type: object
                                          properties:
                                            threshold:
                                              type: number
                                              description: 建议阈值，仅作为参考，实际应用中根据测试情况选取合适的score阈值即可
                                            score:
                                              type: number
                                              description: 对应概率分数
                                          description: 使用手机
                                        both_hands_leaving_wheel:
                                          type: object
                                          properties:
                                            threshold:
                                              type: number
                                              description: 建议阈值，仅作为参考，实际应用中根据测试情况选取合适的score阈值即可
                                            score:
                                              type: number
                                              description: 对应概率分数
                                          description: 双手离开方向盘
                                        not_facing_front:
                                          type: object
                                          properties:
                                            threshold:
                                              type: number
                                              description: 建议阈值，仅作为参考，实际应用中根据测试情况选取合适的score阈值即可
                                            score:
                                              type: number
                                              description: 对应概率分数
                                          description: 视角未朝前方
                                        not_buckling_up:
                                          type: object
                                          properties:
                                            threshold:
                                              type: number
                                              description: 建议阈值，仅作为参考，实际应用中根据测试情况选取合适的score阈值即可
                                            score:
                                              type: number
                                              description: 对应概率分数
                                          description: 未系安全带
                                        smoke:
                                          type: object
                                          properties:
                                            threshold:
                                              type: number
                                              description: 建议阈值，仅作为参考，实际应用中根据测试情况选取合适的score阈值即可
                                            score:
                                              type: number
                                              description: 对应概率分数
                                          description: 吸烟
                                      description: 驾驶员属性行为内容
                                    location:
                                      type: object
                                      properties:
                                        width:
                                          type: number
                                          description: |
                                            检测区域宽度
                                        top:
                                          type: number
                                          description: |
                                            检测区域在原图的上起开始位置
                                        height:
                                          type: number
                                          description: |
                                            检测区域高度
                                        left:
                                          type: number
                                          description: |
                                            检测区域在原图的左起开始位置
                                      description: 检测出驾驶员的位置
                            description: 驾驶员的属性行为信息；若未检测到驾驶员，则该项为[]
                          log_id:
                            type: number
                        description: 业务返回体
      operationId: 2571_6_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ds_id:
                  type: string
                  description: 数据源
                image:
                  type: string
                  minLength: 0
                  maxLength: 10000000
                  description: 图像数据，base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M。图片的base64编码是不包含图片头的，如(data:image/jpg;base64,)，支持图片格式：jpg、bmp、png，最短边至少50px，最长边最大4096px
                type:
                  type: string
                  description: |-
                    识别的属性行为类别，英文逗号分隔，默认所有属性都识别；
                    smoke //吸烟，
                    cellphone //打手机 ，
                    not_buckling_up // 未系安全带，
                    both_hands_leaving_wheel // 双手离开方向盘，
                    not_facing_front // 视角未看前方，
                    no_face_mask // 未正确佩戴口罩，
                    yawning // 打哈欠，
                    eyes_closed // 闭眼，
                    head_lowered // 低头
                wheel_location:
                  type: string
                  description: |-
                    默认值"1"，表示左舵车（普遍适用于中国大陆地区，若图像中检测到多个大小相当的人体，默认取画面中右侧最大的人体作为驾驶员）；
                    "0"表示右舵车（适用于香港等地区，若图像中检测到多个大小相当的人体，则取画面中左侧最大的人体作为驾驶员）；
                    其他输入值视为非法输入，直接使用默认值
              required:
                - ds_id
                - image
  /2571-5:
    x-pointCode: 5
    x-mode: mapping
    x-read-timeout: 30
    x-connect-timeout: 30
    post:
      summary: 人像分割
      description: 识别图像中的人体轮廓，与背景进行分离，适应单人自拍、多人体、复杂背景、各类人体姿态；广泛应用于人像抠图美化、照片背景替换、证件照制作等娱乐互动场景。原接口订购地址：https://cloud.baidu.com/product/body
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          log_id:
                            type: number
                          labelmap:
                            type: string
                            description: 分割结果图片，base64编码之后的二值图像，需二次处理方能查看分割效果
                          scoremap:
                            type: string
                            description: 分割后人像前景的scoremap，归一到0-255，不用进行二次处理，直接解码保存图片即可。Base64编码后的灰度图文件，图片中每个像素点的灰度值 = 置信度 * 255，置信度为原图对应像素点位于人体轮廓内的置信度，取值范围[0, 1]
                          foreground:
                            type: string
                            description: 分割后的人像前景抠图，透明背景，Base64编码后的png格式图片，不用进行二次处理，直接解码保存图片即可。将置信度大于0.5的像素抠出来，并通过image matting技术消除锯齿
                        description: 业务返回体
      operationId: 2571_5_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ds_id:
                  type: string
                  description: 数据源
                image:
                  type: string
                  minLength: 0
                  maxLength: 10000000
                  description: 图像数据，base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4m。图片的base64编码是不包含图片头的，如（data:image/jpg;base64,），支持图片格式：jpg、bmp、png，最短边至少50px，最长边最大4096px
                type:
                  type: string
                  description: 可以通过设置type参数，自主设置返回哪些结果图，避免造成带宽的浪费1）可选值说明：labelmap - 二值图像，需二次处理方能查看分割效果scoremap - 人像前景灰度图foreground - 人像前景抠图，透明背景2）type 参数值可以是可选值的组合，用逗号分隔；如果无此参数默认输出全部3类结果图
              required:
                - ds_id
                - image
  /2571-4:
    x-pointCode: 4
    x-mode: mapping
    x-read-timeout: 30
    x-connect-timeout: 30
    post:
      summary: 手势识别
      description: 识别图片中的手部位置和手势类型，可识别24种常见手势，包括拳头、OK、比心、作揖、作别、祈祷、我爱你、点赞、Diss、Rock、竖中指、数字等。原接口订购地址：https://cloud.baidu.com/product/body
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          log_id:
                            type: number
                            description: 唯一的log id，用于问题定位
                          result_num:
                            type: number
                            description: |
                              结果数量
                          result:
                            type: array
                            items:
                              type: object
                              properties:
                                "0":
                                  type: object
                                  properties:
                                    probability:
                                      type: number
                                      description: 目标属于该类别的概率
                                    top:
                                      type: number
                                      description: 目标框上坐标
                                    height:
                                      type: number
                                      description: 目标框的高
                                    classname:
                                      type: string
                                      description: 目标所属类别，24种手势、other、face
                                    width:
                                      type: number
                                      description: 目标框的宽
                                    left:
                                      type: number
                                      description: 目标框最左坐标
                            description: 检测到的目标，手势、人脸
                        description: 业务返回体
      operationId: 2571_4_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ds_id:
                  type: string
                  description: 数据源
                image:
                  type: string
                  minLength: 0
                  maxLength: 10000000
                  description: 图像数据，base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4m。图片的base64编码是不包含图片头的，如（data:image/jpg;base64,），支持图片格式：jpg、bmp、png，最短边至少50px，最长边最大4096px
              required:
                - ds_id
                - image
  /2571-3:
    x-pointCode: 3
    x-mode: mapping
    x-read-timeout: 30
    x-connect-timeout: 30
    post:
      summary: 人流量统计
      description: 统计图像中的人体个数和流动趋势，以头肩为主要识别目标统计人数，无需正脸、全身照，适应人群密集、各种出入口场景。原接口订购地址：https://cloud.baidu.com/product/body
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          log_id:
                            type: number
                          person_num:
                            type: number
                            description: 识别出的人体数目；当未设置area参数时，返回的是全图人数；设置了有效的area参数时，返回的人数是所有区域的人数总和（所有区域求并集后的不规则区域覆盖的人数）
                          image:
                            type: string
                            description: |
                              渲染后的图片，输入参数show=true时输出该字段
                          area_counts:
                            type: array
                            items:
                              type: number
                            description: 每一个框选区域的人数，仅当请求中有area参数且参数有效时才会返回，否则该字段不返回；成功返回示例：[5,3,8]
                        description: 业务返回体
      operationId: 2571_3_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ds_id:
                  type: string
                  description: 数据源
                image:
                  type: string
                  minLength: 0
                  maxLength: 10000000
                  description: 图像数据，base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4m。图片的base64编码是不包含图片头的，如（data:image/jpg;base64,），支持图片格式：jpg、bmp、png，最短边至少50px，最长边最大4096px
                area:
                  type: string
                  description: 特定框选区域坐标，支持多个多边形区域，最多支持10个区域，如输入超过10个区域，截取前10个区域进行识别。此参数为空或无此参数、或area参数设置错误时，默认识别整个图片的人数 。area参数设置错误的示例：某个坐标超过原图大小，x、y坐标未成对出现等；注意：设置了多个区域时，任意一个坐标设置错误，则认为area参数错误、失效。area参数设置格式：1）多个区域用英文分号“;”分隔；2）同一个区域内的坐标用英文逗号“,”分隔，默认尾点和首点相连做闭合。示例：1）单个多边形区域：x1,y1,x2,y2,x3,y3...xn,yn2）多个多边形区域：xa1,ya1,xa2,ya2,xa3,ya3...xan,yan;xb1,yb1,xb2,yb2,xb3,yb3...xbn,ybn;...
                show:
                  type: string
                  description: 是否输出渲染的图片，默认不返回，选true时返回渲染后的图片(base64)，其它无效值或为空则默认false
              required:
                - ds_id
                - image
  /2571-2:
    x-pointCode: 2
    x-mode: mapping
    x-read-timeout: 30
    x-connect-timeout: 30
    post:
      summary: 人体检测和属性识别
      description: 检测图像中的所有人体，返回每个人体的位置坐标；识别人体的20余类属性信息，包含性别年龄、服饰类别、服饰颜色、戴帽子（可区分安全帽/普通帽）、戴口罩、背包、抽烟、使用手机等。原接口订购地址：https://cloud.baidu.com/product/body
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          person_num:
                            type: number
                            description: 识别到的人体数量
                          person_info:
                            type: array
                            items:
                              type: object
                              properties:
                                "0":
                                  type: object
                                  properties:
                                    attributes:
                                      type: object
                                      properties:
                                        upper_wear_fg:
                                          type: object
                                          properties:
                                            score:
                                              type: number
                                              description: 对应概率分数
                                            name:
                                              type: string
                                              description: T恤、无袖、衬衫、西装、毛衣、夹克、羽绒服、风衣、外套
                                          description: 上身服饰细分类
                                        cellphone:
                                          type: object
                                          properties:
                                            score:
                                              type: number
                                              description: 对应概率分数
                                            name:
                                              type: string
                                              description: 未使用手机、使用手机、不确定
                                          description: 是否使用手机
                                        lower_cut:
                                          type: object
                                          properties:
                                            score:
                                              type: number
                                              description: 对应概率分数
                                            name:
                                              type: string
                                              description: 无下方截断，有下方截断
                                          description: 下方截断
                                        umbrella:
                                          type: object
                                          properties:
                                            score:
                                              type: number
                                              description: 对应概率分数
                                            name:
                                              type: string
                                              description: 未撑伞、撑伞
                                          description: 是否撑伞
                                        orientation:
                                          type: object
                                          properties:
                                            score:
                                              type: number
                                              description: 对应概率分数
                                            name:
                                              type: string
                                              description: 正面、背面、侧面
                                          description: 身体朝向
                                        headwear:
                                          type: object
                                          properties:
                                            score:
                                              type: number
                                              description: 对应概率分数
                                            name:
                                              type: string
                                              description: 无帽、普通帽、安全帽
                                          description: 是否戴帽子
                                        gender:
                                          type: object
                                          properties:
                                            score:
                                              type: number
                                              description: 对应概率分数
                                            name:
                                              type: string
                                              description: 男性、女性
                                          description: 性别
                                        age:
                                          type: object
                                          properties:
                                            score:
                                              type: number
                                              description: 对应概率分数
                                            name:
                                              type: string
                                              description: 幼儿、青少年、青年、中年、老年
                                          description: 年龄阶段
                                        upper_cut:
                                          type: object
                                          properties:
                                            score:
                                              type: number
                                              description: 对应概率分数
                                            name:
                                              type: string
                                              description: 无上方截断，有上方截断
                                          description: 上方截断
                                        glasses:
                                          type: object
                                          properties:
                                            score:
                                              type: number
                                              description: 对应概率分数
                                            name:
                                              type: string
                                              description: 戴眼镜、戴墨镜、无眼镜、不确定
                                          description: 是否戴眼镜
                                        lower_color:
                                          type: object
                                          properties:
                                            score:
                                              type: number
                                            name:
                                              type: string
                                              description: 红、橙、黄、绿、蓝、紫、粉、黑、白、灰、棕
                                          description: 下半身衣着颜色
                                        bag:
                                          type: object
                                          properties:
                                            score:
                                              type: number
                                            name:
                                              type: string
                                              description: 无背包、单肩包、双肩包
                                          description: 背包
                                        upper_wear_texture:
                                          type: object
                                          properties:
                                            score:
                                              type: number
                                            name:
                                              type: string
                                              description: 纯色、图案、碎花、条纹或格子
                                          description: 上身服饰纹理
                                        smoke:
                                          type: object
                                          properties:
                                            score:
                                              type: number
                                            name:
                                              type: string
                                              description: 未吸烟、吸烟、不确定
                                          description: 是否吸烟
                                        vehicle:
                                          type: object
                                          properties:
                                            score:
                                              type: number
                                            name:
                                              type: string
                                              description: 无交通工具、骑摩托车、骑自行车、骑三轮车
                                          description: 交通工具
                                        lower_wear:
                                          type: object
                                          properties:
                                            score:
                                              type: number
                                            name:
                                              type: string
                                              description: 长裤、短裤、长裙、短裙、不确定
                                          description: 下半身服饰
                                        carrying_item:
                                          type: object
                                          properties:
                                            score:
                                              type: number
                                            name:
                                              type: string
                                              description: 无手提物、有手提物、不确定
                                          description: 是否有手提物
                                        upper_wear:
                                          type: object
                                          properties:
                                            score:
                                              type: number
                                            name:
                                              type: string
                                              description: 长袖、短袖
                                          description: 上半身服饰
                                        occlusion:
                                          type: object
                                          properties:
                                            score:
                                              type: number
                                            name:
                                              type: string
                                              description: 无遮挡、轻度遮挡、重度遮挡
                                          description: 遮挡
                                        upper_color:
                                          type: object
                                          properties:
                                            score:
                                              type: number
                                            name:
                                              type: string
                                              description: 红、橙、黄、绿、蓝、紫、粉、黑、白、灰、棕
                                          description: 上身服饰颜色
                                        is_human:
                                          type: object
                                          properties:
                                            score:
                                              type: number
                                            name:
                                              type: string
                                              description: 正常人体，非正常人体
                                          description: 是否是正常人体
                                      description: 人体属性内容
                                    location:
                                      type: object
                                      properties:
                                        height:
                                          type: number
                                          description: 人体区域的高度
                                        width:
                                          type: number
                                          description: 人体区域的宽度
                                        top:
                                          type: number
                                          description: 人体区域离上边界的距离
                                        score:
                                          type: number
                                          description: 对应概率分数
                                        left:
                                          type: number
                                          description: 人体区域离左边界的距离
                                      description: 人体坐标信息
                            description: 人体姿态信息
                          log_id:
                            type: number
                            description: 唯一的log id，用于问题定位
                        description: 业务返回体
      operationId: 2571_2_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ds_id:
                  type: string
                  description: 数据源
                image:
                  type: string
                  minLength: 0
                  maxLength: 10000000
                  description: 图像数据，base64编码字符串，以图片文件形式请求时必填。图片的base64编码是不包含图片头的，如（data:image/jpg;base64,），（支持图片格式：jpg，bmp，png），图片base64编码后大小不超过4m。最短边至少50px，最长边最大4096px。
                type:
                  type: string
                  description: 1）可选值说明：gender-性别，age-年龄阶段，lower_wear-下身服饰，upper_wear-上身服饰，headwear-是否戴帽子，glasses-是否戴眼镜，upper_color-上身服饰颜色，lower_color-下身服饰颜色，cellphone-是否使用手机，upper_wear_fg-上身服饰细分类，upper_wear_texture-上身服饰纹理，orientation-身体朝向，umbrella-是否撑伞；bag-背包,smoke-是否吸烟,vehicle-交通工具,carrying_item-是否有手提物,upper_cut-上方截断,lower_cut-下方截断,occlusion-遮挡,is_human-是否是正常人体2）type 参数值可以是可选值的组合，用逗号分隔；如果无此参数默认输出全部21个属性
              required:
                - ds_id
                - image
  /2571-1:
    x-pointCode: 1
    x-mode: mapping
    x-read-timeout: 30
    x-connect-timeout: 30
    post:
      summary: 人体关键点识别
      description: 检测图像中的人体并返回人体矩形框位置，精准定位21个核心关键点，包含头顶、五官、颈部、四肢主要关节部位，支持多人检测、大动作等复杂场景。原接口订购地址：https://cloud.baidu.com/product/body
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          person_num:
                            type: number
                            description: 人体数目
                          person_info:
                            type: array
                            items:
                              type: object
                              properties:
                                "0":
                                  type: object
                                  properties:
                                    body_parts:
                                      type: object
                                      properties:
                                        left_hip:
                                          type: object
                                          properties:
                                            y:
                                              type: number
                                              description: y坐标
                                            x:
                                              type: number
                                              description: x坐标
                                            score:
                                              type: number
                                              description: 概率分数
                                          description: 左髋部
                                        top_head:
                                          type: object
                                          properties:
                                            y:
                                              type: number
                                              description: y坐标
                                            x:
                                              type: number
                                              description: x坐标
                                            score:
                                              type: number
                                              description: 概率分数
                                          description: 头顶
                                        right_mouth_corner:
                                          type: object
                                          properties:
                                            y:
                                              type: number
                                              description: y坐标
                                            x:
                                              type: number
                                              description: x坐标
                                            score:
                                              type: number
                                              description: 概率分数
                                          description: 右嘴角
                                        neck:
                                          type: object
                                          properties:
                                            y:
                                              type: number
                                              description: y坐标
                                            x:
                                              type: number
                                              description: x坐标
                                            score:
                                              type: number
                                              description: 概率分数
                                          description: 颈部
                                        left_shoulder:
                                          type: object
                                          properties:
                                            y:
                                              type: number
                                            x:
                                              type: number
                                            score:
                                              type: number
                                          description: 左肩
                                        left_knee:
                                          type: object
                                          properties:
                                            y:
                                              type: number
                                            x:
                                              type: number
                                            score:
                                              type: number
                                          description: 左膝
                                        left_ankle:
                                          type: object
                                          properties:
                                            y:
                                              type: number
                                            x:
                                              type: number
                                            score:
                                              type: number
                                          description: 左脚踝
                                        left_mouth_corner:
                                          type: object
                                          properties:
                                            y:
                                              type: number
                                            x:
                                              type: number
                                            score:
                                              type: number
                                          description: 左嘴角
                                        right_elbow:
                                          type: object
                                          properties:
                                            y:
                                              type: number
                                            x:
                                              type: number
                                            score:
                                              type: number
                                          description: 右手肘
                                        right_ear:
                                          type: object
                                          properties:
                                            y:
                                              type: number
                                            x:
                                              type: number
                                            score:
                                              type: number
                                          description: 右耳
                                        nose:
                                          type: object
                                          properties:
                                            y:
                                              type: number
                                            x:
                                              type: number
                                            score:
                                              type: number
                                          description: 鼻子
                                        left_eye:
                                          type: object
                                          properties:
                                            y:
                                              type: number
                                            x:
                                              type: number
                                            score:
                                              type: number
                                          description: 左眼
                                        right_eye:
                                          type: object
                                          properties:
                                            y:
                                              type: number
                                            x:
                                              type: number
                                            score:
                                              type: number
                                          description: 右眼
                                        right_hip:
                                          type: object
                                          properties:
                                            y:
                                              type: number
                                            x:
                                              type: number
                                            score:
                                              type: number
                                          description: 右髋部
                                        left_wrist:
                                          type: object
                                          properties:
                                            y:
                                              type: number
                                            x:
                                              type: number
                                            score:
                                              type: number
                                          description: 左手腕
                                        left_ear:
                                          type: object
                                          properties:
                                            y:
                                              type: number
                                            x:
                                              type: number
                                            score:
                                              type: number
                                          description: 左耳
                                        left_elbow:
                                          type: object
                                          properties:
                                            y:
                                              type: number
                                            x:
                                              type: number
                                            score:
                                              type: number
                                          description: 左手肘
                                        right_shoulder:
                                          type: object
                                          properties:
                                            y:
                                              type: number
                                            x:
                                              type: number
                                            score:
                                              type: number
                                          description: 右肩
                                        right_ankle:
                                          type: object
                                          properties:
                                            y:
                                              type: number
                                            x:
                                              type: number
                                            score:
                                              type: number
                                          description: 右脚踝
                                        right_knee:
                                          type: object
                                          properties:
                                            y:
                                              type: number
                                            x:
                                              type: number
                                            score:
                                              type: number
                                          description: 右膝
                                        right_wrist:
                                          type: object
                                          properties:
                                            y:
                                              type: number
                                            x:
                                              type: number
                                            score:
                                              type: number
                                          description: 右手腕
                                      description: 身体部位信息，包含14个关键点
                                    location:
                                      type: object
                                      properties:
                                        height:
                                          type: number
                                          description: 人体区域的高度
                                        width:
                                          type: number
                                          description: 人体区域的宽度
                                        top:
                                          type: number
                                          description: 人体区域离上边界的距离
                                        score:
                                          type: number
                                          description: |
                                            人体框的概率分数
                                        left:
                                          type: number
                                          description: 人体区域离左边界的距离
                                      description: 人体坐标信息
                            description: 人体姿态信息
                          log_id:
                            type: string
                        description: 业务返回体
      operationId: 2571_1_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ds_id:
                  type: string
                  description: 数据源
                image:
                  type: string
                  minLength: 0
                  maxLength: 10000000
                  description: 图像数据，base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4m。图片的base64编码是不包含图片头的，如(data:image/jpg;base64,)，支持图片格式：jpg、bmp、png，最短边至少50px，最长边最大4096px
              required:
                - ds_id
                - image
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/2571?tab=book
x-apiCode: "2571"
x-is-own: false
x-is-op: false
