{
  "name": "ft",
  "display_name": "人像变换",
  "description": "介绍如何使用API对人像变换进行操作，包括人脸性别转换、人脸年龄变化等。",
  "domain": "other",
  "api_version": "2020-03-04",
  "endpoint": "ft.tencentcloudapi.com",
  "actions": [
    {
      "name": "CancelFaceMorphJob",
      "description": "撤销人像渐变任务请求",
      "status": "online",
      "parameters": [
        {
          "name": "JobId",
          "type": "string",
          "required": true,
          "description": "人像渐变任务Job id",
          "example": "004C6B6FFEA31433875D55115E09E945A03"
        }
      ],
      "required": [
        "JobId"
      ]
    },
    {
      "name": "ChangeAgePic",
      "description": "用户上传一张人脸图片，基于人脸编辑与生成算法，输出一张人脸变老或变年轻的图片，支持实现人脸不同年龄的变化。",
      "status": "online",
      "parameters": [
        {
          "name": "AgeInfos",
          "type": "array",
          "required": true,
          "description": "人脸变老变年轻信息。 您可以输入最多3个 AgeInfo 来实现给一张图中的最多3张人脸变老变年轻。",
          "example": "[{\"Age\": 10, \"FaceRect\": {\"X\": 10, \"Y\": 10, \"Width\": 20, \"Height\": 20}}]",
          "item_type": "object",
          "children": [
            {
              "name": "Age",
              "type": "integer",
              "required": true,
              "description": "变化到的人脸年龄 [10,80]。",
              "example": "10"
            },
            {
              "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": "Y",
                  "type": "integer",
                  "required": true,
                  "description": "人脸框左上角纵坐标。",
                  "example": "1"
                },
                {
                  "name": "X",
                  "type": "integer",
                  "required": true,
                  "description": "人脸框左上角横坐标。",
                  "example": "1"
                },
                {
                  "name": "Width",
                  "type": "integer",
                  "required": true,
                  "description": "人脸框宽度。",
                  "example": "1"
                },
                {
                  "name": "Height",
                  "type": "integer",
                  "required": true,
                  "description": "人脸框高度。",
                  "example": "1"
                }
              ]
            }
          ]
        },
        {
          "name": "Image",
          "type": "string",
          "required": false,
          "description": "图片 base64 数据，base64 编码后大小不可超过5M。 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
          "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 图片。",
          "example": "https://liudehua-9527.cos.ap-guangzhou.myqcloud.com/input.jpeg"
        },
        {
          "name": "RspImgType",
          "type": "string",
          "required": false,
          "description": "返回图像方式（base64 或 url ) ，二选一。url有效期为1天。默认值为base64。",
          "example": "url"
        }
      ],
      "required": [
        "AgeInfos"
      ]
    },
    {
      "name": "FaceCartoonPic",
      "description": "输入一张人脸照片，生成个性化的二次元动漫形象，可用于打造个性头像、趣味活动、特效类应用等场景，提升社交娱乐的体验。",
      "status": "online",
      "parameters": [
        {
          "name": "Image",
          "type": "string",
          "required": false,
          "description": "图片 base64 数据，base64 编码后大小不可超过5M。 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
          "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 图片。",
          "example": "https://liudehua-9527.cos.ap-guangzhou.myqcloud.com/input.jpeg"
        },
        {
          "name": "RspImgType",
          "type": "string",
          "required": false,
          "description": "返回图像方式（base64 或 url ) ，二选一。url有效期为1天。",
          "example": "url"
        },
        {
          "name": "DisableGlobalEffect",
          "type": "string",
          "required": false,
          "description": "关闭全图动漫化，传入true（不分大小写）即关闭全图动漫化。",
          "example": "true"
        }
      ],
      "required": []
    },
    {
      "name": "MorphFace",
      "description": "输入2-5张人脸照片，生成一段以人脸为焦点的渐变视频或GIF图，支持自定义图片播放速度、视频每秒传输帧数，可用于短视频、表情包、创意H5等应用场景，丰富静态图片的玩法。",
      "status": "online",
      "parameters": [
        {
          "name": "Images",
          "type": "array",
          "required": false,
          "description": "图片 base64 数据，base64 编码后大小不可超过5M。 jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 人员人脸总数量至少2张，不可超过5张。 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
          "example": "[\"/9j/4AAQSkZJRgABAQAAAQABAAD/4gIo...lftXF/DjFZNXoSP5V2U0HMt/1FQf/Z\"]",
          "item_type": "string"
        },
        {
          "name": "Urls",
          "type": "array",
          "required": false,
          "description": "图片的 Url 。对应图片 base64 编码后大小不可超过5M。jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。 Url、Image必须提供一个，如果都提供，只使用 Url。图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 非腾讯云存储的Url速度和稳定性可能受一定影响。 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 人员人脸总数量不可超过5张。 若图片...",
          "example": "[\"https://liudehua-9527.cos.ap-guangzhou.myqcloud.com/input.jpeg\"]",
          "item_type": "string"
        },
        {
          "name": "GradientInfos",
          "type": "array",
          "required": false,
          "description": "人脸渐变参数。可调整每张图片的展示时长、人像渐变的最长时间",
          "example": "[{\"Tempo\": 0.5, \"MorphTime\": 0.5}]",
          "item_type": "object",
          "children": [
            {
              "name": "Tempo",
              "type": "float",
              "required": false,
              "description": "图片的展示时长，即单张图片静止不变的时间。GIF默认每张图片0.7s，视频默认每张图片0.5s。最大取值1s。",
              "example": "0.5"
            },
            {
              "name": "MorphTime",
              "type": "float",
              "required": false,
              "description": "人像渐变的最长时间，即单张图片使用渐变特效的时间。 GIF默认值为0.5s，视频默值认为1s。最大取值1s。",
              "example": "0.5"
            }
          ]
        },
        {
          "name": "Fps",
          "type": "integer",
          "required": false,
          "description": "视频帧率，取值[1,25]。默认10",
          "example": "10"
        },
        {
          "name": "OutputType",
          "type": "integer",
          "required": false,
          "description": "视频类型，取值0。目前仅支持MP4格式，默认为MP4格式",
          "example": "0"
        },
        {
          "name": "OutputWidth",
          "type": "integer",
          "required": false,
          "description": "视频宽度，取值[128,1280]。默认值720",
          "example": "128"
        },
        {
          "name": "OutputHeight",
          "type": "integer",
          "required": false,
          "description": "视频高度，取值[128,1280]。默认值1280",
          "example": "128"
        }
      ],
      "required": []
    },
    {
      "name": "QueryFaceMorphJob",
      "description": "查询人像渐变处理进度",
      "status": "online",
      "parameters": [
        {
          "name": "JobId",
          "type": "string",
          "required": true,
          "description": "人像渐变任务Job id",
          "example": "Iyjz4Rj3OCt5Az9a"
        }
      ],
      "required": [
        "JobId"
      ]
    },
    {
      "name": "SwapGenderPic",
      "description": "用户上传一张人脸图片，基于人脸编辑与生成算法，输出一张人脸性别转换的图片。男变女可实现美颜、淡妆、加刘海和长发的效果；女变男可实现加胡须、变短发的效果。",
      "status": "online",
      "parameters": [
        {
          "name": "GenderInfos",
          "type": "array",
          "required": true,
          "description": "人脸转化性别信息。 您可以输入最多3个 GenderInfo 来实现给一张图中的最多3张人脸转换性别。",
          "example": "[{\"Gender\": 1, \"FaceRect\": {\"X\": 10, \"Y\": 10, \"Width\": 20, \"Height\": 20}}]",
          "item_type": "object",
          "children": [
            {
              "name": "Gender",
              "type": "integer",
              "required": true,
              "description": "选择转换方向，0：男变女，1：女变男。",
              "example": "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": "Y",
                  "type": "integer",
                  "required": true,
                  "description": "人脸框左上角纵坐标。",
                  "example": "1"
                },
                {
                  "name": "X",
                  "type": "integer",
                  "required": true,
                  "description": "人脸框左上角横坐标。",
                  "example": "1"
                },
                {
                  "name": "Width",
                  "type": "integer",
                  "required": true,
                  "description": "人脸框宽度。",
                  "example": "1"
                },
                {
                  "name": "Height",
                  "type": "integer",
                  "required": true,
                  "description": "人脸框高度。",
                  "example": "1"
                }
              ]
            }
          ]
        },
        {
          "name": "Image",
          "type": "string",
          "required": false,
          "description": "图片 base64 数据，base64 编码后大小不可超过5M。 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。",
          "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 图片。",
          "example": "https://liudehua-9527.cos.ap-guangzhou.myqcloud.com/input.jpeg"
        },
        {
          "name": "RspImgType",
          "type": "string",
          "required": false,
          "description": "返回图像方式（base64 或 url ) ，二选一。url有效期为1天。",
          "example": "url"
        }
      ],
      "required": [
        "GenderInfos"
      ]
    }
  ]
}