{
  "name": "fmu",
  "display_name": "人脸试妆",
  "description": "介绍如何使用API对人脸试妆进行操作，包括试唇色、人脸美颜等。",
  "domain": "other",
  "api_version": "2019-12-13",
  "endpoint": "fmu.tencentcloudapi.com",
  "actions": [
    {
      "name": "BeautifyPic",
      "description": "用户上传一张人脸图片（最多能处理一张图片中最大的五张人脸信息），精准定位五官，实现美肤、亮肤、祛痘等美颜功能。",
      "status": "online",
      "parameters": [
        {
          "name": "Image",
          "type": "string",
          "required": false,
          "description": "图片 base64 数据，base64 编码后大小不可超过5M，单边分辨率不超过4000。 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 暂不支持带有alpha透明通道的图片。",
          "example": "/9j/4AAQSkZJRgABAQAAAQABAAD/4gIo...lftXF/DjFZNXoSP5V2U0HMt/1FQf/Z"
        },
        {
          "name": "Url",
          "type": "string",
          "required": false,
          "description": "图片的 Url 。对应图片 base64 编码后大小不可超过5M。，单边分辨率不超过4000。 Url、Image必须提供一个，如果都提供，只使用 Url。 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 非腾讯云存储的Url速度和稳定性可能受一定影响。 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 暂不支持带有alpha透明通道的图片。",
          "example": "https://liudehua-9527.cos.ap-guangzhou.myqcloud.com/input.jpeg"
        },
        {
          "name": "Whitening",
          "type": "integer",
          "required": false,
          "description": "美白程度，取值范围[0,100]。0不美白，100代表最高程度。默认值30。",
          "example": "1"
        },
        {
          "name": "Smoothing",
          "type": "integer",
          "required": false,
          "description": "磨皮程度，取值范围[0,100]。0不磨皮，100代表最高程度。默认值10。",
          "example": "1"
        },
        {
          "name": "FaceLifting",
          "type": "integer",
          "required": false,
          "description": "瘦脸程度，取值范围[0,100]。0不瘦脸，100代表最高程度。默认值70。",
          "example": "1"
        },
        {
          "name": "EyeEnlarging",
          "type": "integer",
          "required": false,
          "description": "大眼程度，取值范围[0,100]。0不大眼，100代表最高程度。默认值70。",
          "example": "1"
        },
        {
          "name": "RspImgType",
          "type": "string",
          "required": false,
          "description": "返回图像方式（base64 或 url ) ，二选一。url有效期为1天。",
          "example": "base64"
        }
      ],
      "required": []
    },
    {
      "name": "CreateModel",
      "description": "在使用LUT素材的modelid实现试唇色前，您需要先上传 LUT 格式的cube文件注册唇色ID。查看 [LUT文件的使用说明](https://cloud.tencent.com/document/product/1172/41701)。 注：您也可以直接使用 [试唇色接口](https://cloud.tencent.com/document/product/1172/40706)，通过输入RGBA模型数值的方式指定唇色，更简单易用。",
      "status": "online",
      "parameters": [
        {
          "name": "LUTFile",
          "type": "string",
          "required": true,
          "description": "图片base64数据，用于试唇色，要求必须是LUT 格式的cube文件转换成512*512的PNG图片。查看 [LUT文件的使用说明](https://cloud.tencent.com/document/product/1172/41701)。了解 [cube文件转png图片小工具](http://yyb.gtimg.com/aiplat/static/qcloud-cube-to-png.html)。",
          "example": "/9j/4AAQSkZJRgABAQAAAQABAAD/4gIo...lftXF/DjFZNXoSP5V2U0HMt/1FQf/Z"
        },
        {
          "name": "Description",
          "type": "string",
          "required": false,
          "description": "文件描述信息，可用于备注。",
          "example": "红色"
        }
      ],
      "required": [
        "LUTFile"
      ]
    },
    {
      "name": "DeleteModel",
      "description": "删除已注册的唇色素材。",
      "status": "online",
      "parameters": [
        {
          "name": "ModelId",
          "type": "string",
          "required": true,
          "description": "素材ID。",
          "example": "mo_0_1731389015111_1259088222_3"
        }
      ],
      "required": [
        "ModelId"
      ]
    },
    {
      "name": "GetModelList",
      "description": "查询已注册的唇色素材。",
      "status": "online",
      "parameters": [
        {
          "name": "Offset",
          "type": "integer",
          "required": false,
          "description": "起始序号，默认值为0。",
          "example": "0"
        },
        {
          "name": "Limit",
          "type": "integer",
          "required": false,
          "description": "返回数量，默认值为10，最大值为100。",
          "example": "1"
        }
      ],
      "required": []
    },
    {
      "name": "StyleImage",
      "description": "上传一张照片，输出滤镜处理后的图片。",
      "status": "online",
      "parameters": [
        {
          "name": "FilterType",
          "type": "integer",
          "required": true,
          "description": "滤镜类型，取值如下： 1.白茶；2 白皙；3.初夏；4.东京；5.告白；6.暖阳；7.蔷薇；8.清澄；9.清透；10.甜薄荷；11.默认；12.心动；13.哑灰；14.樱桃布丁；15.自然；16.清逸；17.黑白；18.水果；19.爱情；20.冬日；21.相片；22.夏日；23.香氛；24.魅惑；25.悸动；26.沙滩；27.街拍；28.甜美；29.初吻；30.午后。",
          "example": "1"
        },
        {
          "name": "Image",
          "type": "string",
          "required": false,
          "description": "图片 base64 数据，base64 编码后大小不可超过5M。 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 暂不支持带有alpha透明通道的图片。",
          "example": "/9j/4AAQSkZJRgABAQAAAQABAAD/4gIo...lftXF/DjFZNXoSP5V2U0HMt/1FQf/Z"
        },
        {
          "name": "Url",
          "type": "string",
          "required": false,
          "description": "图片的 Url ，对应图片 base64 编码后大小不可超过5M。 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。 图片存储于腾讯云的 Url 可保障更高下载速度和稳定性，建议图片存储于腾讯云。 非腾讯云存储的Url速度和稳定性可能受一定影响。 支持PNG、JPG、JPEG、BMP 等图片格式，不支持 GIF 图片。 暂不支持带有alpha透明通道的图片。",
          "example": "https://liudehua-9527.cos.ap-guangzhou.myqcloud.com/input.jpeg"
        },
        {
          "name": "FilterDegree",
          "type": "integer",
          "required": false,
          "description": "滤镜效果，取值[0,100]，0表示无效果，100表示满滤镜效果。默认值为80。",
          "example": "1"
        },
        {
          "name": "RspImgType",
          "type": "string",
          "required": false,
          "description": "返回图像方式（base64 或 url ) ，二选一。url有效期为1天。默认值为base64。",
          "example": "base64"
        }
      ],
      "required": [
        "FilterType"
      ]
    },
    {
      "name": "StyleImagePro",
      "description": "上传一张照片，输出滤镜处理后的图片。",
      "status": "online",
      "parameters": [
        {
          "name": "FilterType",
          "type": "integer",
          "required": true,
          "description": "滤镜类型，取值如下： 1.白茶1；2 白皙；3.初夏；4.东京；5.告白；6.暖阳；7.蔷薇；8.清澄；9.清透；10.甜薄荷；11.默认；12.心动；13.哑灰；14.樱桃布丁；15.自然；16.清逸1；17.黑白；18.水果；19.爱情；20.冬日；21.相片；22.夏日；23.香氛；24.魅惑；25.悸动；26.沙滩；27.街拍；28.甜美；29.初吻；30.午后；31.活力；32.朦胧；33.悦动；34.时尚；35.气泡；36.柠檬；37.棉花糖；38.小溪；39.丽\ufffd\ufffd...",
          "example": "1"
        },
        {
          "name": "Image",
          "type": "string",
          "required": false,
          "description": "图片 base64 数据，base64 编码后大小不可超过5M。 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 暂不支持带有alpha透明通道的图片。",
          "example": "/9j/4AAQSkZJRgABAQAAAQABAAD/4gIo...lftXF/DjFZNXoSP5V2U0HMt/1FQf/Z"
        },
        {
          "name": "Url",
          "type": "string",
          "required": false,
          "description": "图片的 Url ，对应图片 base64 编码后大小不可超过5M。 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。 图片存储于腾讯云的 Url 可保障更高下载速度和稳定性，建议图片存储于腾讯云。 非腾讯云存储的Url速度和稳定性可能受一定影响。 支持PNG、JPG、JPEG、BMP 等图片格式，不支持 GIF 图片。 暂不支持带有alpha透明通道的图片。",
          "example": "https://liudehua-9527.cos.ap-guangzhou.myqcloud.com/input.jpeg"
        },
        {
          "name": "FilterDegree",
          "type": "integer",
          "required": false,
          "description": "滤镜效果，取值[0,100]，0表示无效果，100表示满滤镜效果。默认值为80。",
          "example": "1"
        },
        {
          "name": "RspImgType",
          "type": "string",
          "required": false,
          "description": "返回图像方式（base64 或 url ) ，二选一。url有效期为1天。默认为base64。",
          "example": "base64"
        }
      ],
      "required": [
        "FilterType"
      ]
    },
    {
      "name": "TryLipstickPic",
      "description": "对图片中的人脸嘴唇进行着色，最多支持同时对一张图中的3张人脸进行试唇色。 您可以通过事先注册在腾讯云的唇色素材（LUT文件）改变图片中的人脸唇色，也可以输入RGBA模型数值。 为了更好的效果，建议您使用事先注册在腾讯云的唇色素材（LUT文件）。 \u003e - 公共参数中的签名方式请使用V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。",
      "status": "online",
      "parameters": [
        {
          "name": "LipColorInfos",
          "type": "array",
          "required": true,
          "description": "唇色信息。 您可以输入最多3个 LipColorInfo 来实现给一张图中的最多3张人脸试唇色。",
          "example": "[{\"RGBA\":{\"R\":220,\"G\":2,\"B\":44,\"A\":50},\"ModelAlpha\":50}]",
          "item_type": "object",
          "children": [
            {
              "name": "RGBA",
              "type": "object",
              "required": false,
              "description": "使用RGBA模型试唇色。",
              "example": "{\"R\":220,\"G\":2,\"B\":44,\"A\":50}",
              "children": [
                {
                  "name": "R",
                  "type": "integer",
                  "required": true,
                  "description": "R通道数值。[0,255]。",
                  "example": "220"
                },
                {
                  "name": "G",
                  "type": "integer",
                  "required": true,
                  "description": "G通道数值。[0,255]。",
                  "example": "2"
                },
                {
                  "name": "B",
                  "type": "integer",
                  "required": true,
                  "description": "B通道数值。[0,255]。",
                  "example": "44"
                },
                {
                  "name": "A",
                  "type": "integer",
                  "required": true,
                  "description": "A通道数值。[0,100]。建议取值50。",
                  "example": "50"
                }
              ]
            },
            {
              "name": "ModelId",
              "type": "string",
              "required": false,
              "description": "使用已注册的 LUT 文件试唇色。 ModelId 和 RGBA 两个参数只需提供一个，若都提供只使用 ModelId。",
              "example": "mo_0_1622620141111_1259088111_1"
            },
            {
              "name": "FaceRect",
              "type": "object",
              "required": false,
              "description": "人脸框位置。若不输入则选择 Image 或 Url 中面积最大的人脸。 您可以通过 [人脸检测与分析](https://cloud.tencent.com/document/api/867/32800) 接口获取人脸框位置信息。",
              "example": "{\"X\": 10, \"Y\": 10, \"Width\": 20, \"Height\": 20}",
              "children": [
                {
                  "name": "X",
                  "type": "integer",
                  "required": true,
                  "description": "人脸框左上角横坐标。",
                  "example": "10"
                },
                {
                  "name": "Y",
                  "type": "integer",
                  "required": true,
                  "description": "人脸框左上角纵坐标。",
                  "example": "10"
                },
                {
                  "name": "Width",
                  "type": "integer",
                  "required": true,
                  "description": "人脸框宽度。",
                  "example": "20"
                },
                {
                  "name": "Height",
                  "type": "integer",
                  "required": true,
                  "description": "人脸框高度。",
                  "example": "20"
                }
              ]
            },
            {
              "name": "ModelAlpha",
              "type": "integer",
              "required": false,
              "description": "涂妆浓淡[0,100]。建议取值50。本参数仅控制ModelId对应的涂妆浓淡。",
              "example": "50"
            }
          ]
        },
        {
          "name": "Image",
          "type": "string",
          "required": false,
          "description": "图片 base64 数据，base64 编码后大小不可超过6M。 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 暂不支持带有alpha透明通道的图片。",
          "example": "/9j/4AAQSkZJRgABAQAAAQABAAD/4gIo...lftXF/DjFZNXoSP5V2U0HMt/1FQf/Z"
        },
        {
          "name": "Url",
          "type": "string",
          "required": false,
          "description": "图片的 Url ，对应图片 base64 编码后大小不可超过6M。 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。 图片存储于腾讯云的 Url 可保障更高下载速度和稳定性，建议图片存储于腾讯云。 非腾讯云存储的Url速度和稳定性可能受一定影响。 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 暂不支持带有alpha透明通道的图片。",
          "example": "https://liudehua-9527.cos.ap-guangzhou.myqcloud.com/input.jpeg"
        },
        {
          "name": "RspImgType",
          "type": "string",
          "required": false,
          "description": "返回图像方式（base64 或 url ) ，二选一。url有效期为1天。",
          "example": "base64"
        }
      ],
      "required": [
        "LipColorInfos"
      ]
    }
  ]
}