{
  "name": "bda",
  "display_name": "人体分析",
  "description": "介绍如何使用API对人体分析进行操作，包括人体库管理、人体搜索、人体检测等。",
  "domain": "other",
  "api_version": "2020-03-24",
  "endpoint": "bda.tencentcloudapi.com",
  "actions": [
    {
      "name": "CreateSegmentationTask",
      "description": "本接口为人像分割在线处理接口组中的提交任务接口，可以对提交的资源进行处理视频流/图片流识别视频作品中的人像区域，进行一键抠像、背景替换、人像虚化等后期处理。",
      "status": "online",
      "parameters": [
        {
          "name": "VideoUrl",
          "type": "string",
          "required": true,
          "description": "需要分割的视频URL，可外网访问。",
          "example": "https://liudehua-9527.cos.ap-guangzhou.myqcloud.com/input.mp4"
        },
        {
          "name": "BackgroundImageUrl",
          "type": "string",
          "required": false,
          "description": "背景图片URL。 可以将视频背景替换为输入的图片。 如果不输入背景图片，则输出人像区域mask。",
          "example": "https://liudehua-9527.cos.ap-guangzhou.myqcloud.com/input.jpeg"
        },
        {
          "name": "Config",
          "type": "string",
          "required": false,
          "description": "预留字段，后期用于展示更多识别信息。",
          "example": "{\"X-TEST\": \"test\"}"
        }
      ],
      "required": [
        "VideoUrl"
      ]
    },
    {
      "name": "DescribeSegmentationTask",
      "description": "可以查看单条任务的处理情况，包括处理状态，处理结果。",
      "status": "online",
      "parameters": [
        {
          "name": "TaskID",
          "type": "string",
          "required": true,
          "description": "在提交分割任务成功时返回的任务标识ID。",
          "example": "12433580546999111111"
        }
      ],
      "required": [
        "TaskID"
      ]
    },
    {
      "name": "SegmentCustomizedPortraitPic",
      "description": "在前后景分割的基础上优化多分类分割，支持对头发、五官等的分割，既作为换发型、挂件等底层技术，也可用于抠人头、抠人脸等玩法",
      "status": "online",
      "parameters": [
        {
          "name": "SegmentationOptions",
          "type": "object",
          "required": true,
          "description": "此参数为分割选项，请根据需要选择自己所想从图片中分割的部分。注意所有选项均为非必选，如未选择则值默认为false, 但是必须要保证多于一个选项的描述为true。",
          "example": "{\"Background\": false}",
          "children": [
            {
              "name": "Background",
              "type": "boolean",
              "required": false,
              "description": "分割选项-背景"
            },
            {
              "name": "Hair",
              "type": "boolean",
              "required": false,
              "description": "分割选项-头发"
            },
            {
              "name": "LeftEyebrow",
              "type": "boolean",
              "required": false,
              "description": "分割选项-左眉"
            },
            {
              "name": "RightEyebrow",
              "type": "boolean",
              "required": false,
              "description": "分割选项-右眉"
            },
            {
              "name": "LeftEye",
              "type": "boolean",
              "required": false,
              "description": "分割选项-左眼"
            },
            {
              "name": "RightEye",
              "type": "boolean",
              "required": false,
              "description": "分割选项-右眼"
            },
            {
              "name": "Nose",
              "type": "boolean",
              "required": false,
              "description": "分割选项-鼻子"
            },
            {
              "name": "UpperLip",
              "type": "boolean",
              "required": false,
              "description": "分割选项-上唇"
            },
            {
              "name": "LowerLip",
              "type": "boolean",
              "required": false,
              "description": "分割选项-下唇"
            },
            {
              "name": "Tooth",
              "type": "boolean",
              "required": false,
              "description": "分割选项-牙齿"
            },
            {
              "name": "Mouth",
              "type": "boolean",
              "required": false,
              "description": "分割选项-口腔（不包含牙齿）"
            },
            {
              "name": "LeftEar",
              "type": "boolean",
              "required": false,
              "description": "分割选项-左耳"
            },
            {
              "name": "RightEar",
              "type": "boolean",
              "required": false,
              "description": "分割选项-右耳"
            },
            {
              "name": "Face",
              "type": "boolean",
              "required": false,
              "description": "分割选项-面部(不包含眼、耳、口、鼻等五官及头发。)"
            },
            {
              "name": "Head",
              "type": "boolean",
              "required": false,
              "description": "复合分割选项-头部(包含所有的头部元素，相关装饰除外)"
            },
            {
              "name": "Body",
              "type": "boolean",
              "required": false,
              "description": "分割选项-身体（包含脖子）"
            },
            {
              "name": "Hat",
              "type": "boolean",
              "required": false,
              "description": "分割选项-帽子"
            },
            {
              "name": "Headdress",
              "type": "boolean",
              "required": false,
              "description": "分割选项-头饰"
            },
            {
              "name": "Earrings",
              "type": "boolean",
              "required": false,
              "description": "分割选项-耳环"
            },
            {
              "name": "Necklace",
              "type": "boolean",
              "required": false,
              "description": "分割选项-项链"
            },
            {
              "name": "Belongings",
              "type": "boolean",
              "required": false,
              "description": "分割选项-随身物品（ 例如伞、包、手机等。 ）"
            }
          ]
        },
        {
          "name": "Image",
          "type": "string",
          "required": false,
          "description": "图片 base64 数据，base64 编码后大小不可超过5M。 图片分辨率须小于2000*2000。 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
          "example": "/9j/4AAQSkZJRgABAQAAAQABAAD/4gIo...lftXF/DjFZNXoSP5V2U0HMt/1FQf/Z"
        },
        {
          "name": "Url",
          "type": "string",
          "required": false,
          "description": "图片的 Url 。 Url、Image必须提供一个，如果都提供，只使用 Url。 图片分辨率须小于2000*2000 ，图片 base64 编码后大小不可超过5M。 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 非腾讯云存储的Url速度和稳定性可能受一定影响。 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
          "example": "https://liudehua-9527.cos.ap-guangzhou.myqcloud.com/input.jpeg"
        }
      ],
      "required": [
        "SegmentationOptions"
      ]
    },
    {
      "name": "SegmentPortraitPic",
      "description": "即二分类人像分割，识别传入图片中人体的完整轮廓，进行抠像。",
      "status": "online",
      "parameters": [
        {
          "name": "Image",
          "type": "string",
          "required": false,
          "description": "图片 base64 数据，base64 编码后大小不可超过5M。 图片分辨率须小于2000*2000。 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
          "example": "/9j/4AAQSkZJRgABAQAAAQABAAD/4gIo...lftXF/DjFZNXoSP5V2U0HMt/1FQf/Z"
        },
        {
          "name": "Url",
          "type": "string",
          "required": false,
          "description": "图片的 Url 。 Url、Image必须提供一个，如果都提供，只使用 Url。 图片分辨率须小于2000*2000 ，图片 base64 编码后大小不可超过5M。 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 非腾讯云存储的Url速度和稳定性可能受一定影响。 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
          "example": "https://liudehua-9527.cos.ap-guangzhou.myqcloud.com/input.jpeg"
        },
        {
          "name": "RspImgType",
          "type": "string",
          "required": false,
          "description": "返回图像方式（base64 或 Url ) ，二选一。url有效期为30分钟。",
          "example": "url"
        },
        {
          "name": "Scene",
          "type": "string",
          "required": false,
          "description": "适用场景类型。 取值：GEN/GS。GEN为通用场景模式；GS为绿幕场景模式，针对绿幕场景下的人像分割效果更好。 两种模式选择一种传入，默认为GEN。",
          "example": "GEN"
        }
      ],
      "required": []
    },
    {
      "name": "TerminateSegmentationTask",
      "description": "终止指定视频人像分割处理任务",
      "status": "online",
      "parameters": [
        {
          "name": "TaskID",
          "type": "string",
          "required": true,
          "description": "在提交分割任务成功时返回的任务标识ID。",
          "example": "12433580546999111111"
        }
      ],
      "required": [
        "TaskID"
      ]
    }
  ]
}