{
  "openapi": "3.0.3",
  "info": {
    "title": "百度云-人体分析",
    "description": "体相关信息，提供人体检测与追踪、关键点定位、人流量统计、属性识别、行为分析、人像分割、手势识别、指尖检测等能力。支持本地服务器或专有云服务器私有化部署，保障业务数据的私密性和安全性\n准确识别图像中的人体相关信息。",
    "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、区域进出人数； \nfalse：静态人数统计，返回总人数"
                  },
                  "case_id": {
                    "type": "number",
                    "description": "任务ID（通过case_id区分不同视频流，自拟，不同序列间不可重复即可）\n当dynamic为true时，必填"
                  },
                  "case_init": {
                    "type": "string",
                    "description": "每个case的初始化信号，为true时对该case下的跟踪算法进行初始化，\n为false时重载该case的跟踪状态。\n当为false且读取不到相应case的信息时，直接重新初始化\n当dynamic为true时，必填"
                  },
                  "image": {
                    "type": "string",
                    "minLength": 0,
                    "maxLength": 10000000,
                    "description": "图像数据，base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M。\n图片的base64编码是不包含图片头的，如(data:image/jpg;base64,)，支持图片格式：jpg、bmp、png，最短边至少50px，最长边最大4096px。"
                  },
                  "show": {
                    "type": "string",
                    "description": "是否返回结果图（含统计值和跟踪框渲染），默认不返回，\n选true时返回渲染后的图片(base64)，其它无效值或为空则默认false"
                  },
                  "area": {
                    "type": "string",
                    "description": "当dynamic为true时，必填\n静态人数统计时，只统计区域内的人，缺省时为全图统计。 \n动态人流量统计时，进出区域的人流会被统计。 逗号分隔，如‘x1,y1,x2,y2,x3,y3...xn,yn'，按顺序依次给出每个顶点的xy坐标（默认尾点和首点相连），形成闭合多边形区域。 服务会做范围（顶点左边需在图像范围内）及个数校验（数组长度必须为偶数，且大于3个顶点）。\n只支持单个多边形区域，建议设置矩形框，即4个顶点。\n坐标取值不能超过图像宽度和高度，比如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": "检测区域宽度\n"
                                          },
                                          "top": {
                                            "type": "number",
                                            "description": "检测区域在原图的上起开始位置\n"
                                          },
                                          "height": {
                                            "type": "number",
                                            "description": "检测区域高度\n"
                                          },
                                          "left": {
                                            "type": "number",
                                            "description": "检测区域在原图的左起开始位置\n"
                                          }
                                        },
                                        "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": "识别的属性行为类别，英文逗号分隔，默认所有属性都识别；\nsmoke //吸烟，\ncellphone //打手机 ，\nnot_buckling_up // 未系安全带，\nboth_hands_leaving_wheel // 双手离开方向盘，\nnot_facing_front // 视角未看前方，\nno_face_mask // 未正确佩戴口罩，\nyawning // 打哈欠，\neyes_closed // 闭眼，\nhead_lowered // 低头"
                  },
                  "wheel_location": {
                    "type": "string",
                    "description": "默认值\"1\"，表示左舵车（普遍适用于中国大陆地区，若图像中检测到多个大小相当的人体，默认取画面中右侧最大的人体作为驾驶员）；\n\"0\"表示右舵车（适用于香港等地区，若图像中检测到多个大小相当的人体，则取画面中左侧最大的人体作为驾驶员）；\n其他输入值视为非法输入，直接使用默认值"
                  }
                },
                "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": "结果数量\n"
                            },
                            "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时输出该字段\n"
                            },
                            "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": "人体框的概率分数\n"
                                          },
                                          "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
}