# Generated by ShowAPI OpenAPI generator
# source: market/1962
# generated-at: 2026-06-26T01:56:22.473Z
openapi: 3.0.3
info:
  title: 腾讯云-人脸特效
  description: 人脸融合是依托人脸识别算法和深度学习引擎的面部融合技术，能够快速精准地定位人脸关键点，将用户上传的照片与特定形象进行面部层面融合，使生成的图片同时具备用户与特定形象的外貌特征。
  termsOfService: https://www.showapi.com/helpcenter/view#/4019/2
  version: 1.0.0
servers:
  - url: https://route.showapi.com
paths:
  /1962-7:
    x-pointCode: 7
    x-mode: mapping
    x-read-timeout: 20
    x-connect-timeout: 20
    post:
      summary: 图片滤镜（高级版）
      description: 本接口用于人脸融合，用户上传人脸图片，获取与模板融合后的人脸图片。原接口订购地址：https://cloud.tencent.com/product/fmu
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          Response:
                            type: object
                            properties:
                              ResultImage:
                                type: string
                                description: |-
                                  RspImgType 为 base64 时，返回处理后的图片 base64 数据。默认返回base64
                                  注意：此字段可能返回 null，表示取不到有效值。
                              ResultUrl:
                                type: string
                                description: |-
                                  RspImgType 为 url 时，返回处理后的图片 url 数据。
                                  注意：此字段可能返回 null，表示取不到有效值。
                              RequestId:
                                type: string
                                description: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
                          ret_code:
                            type: number
                        description: 业务返回体
      operationId: 1962_7_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ds_id:
                  type: string
                  description: 数据源
                FilterType:
                  type: number
                  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.午后；31.活力；32.朦胧；33.悦动；34.时尚；35.气泡；36.柠檬；37.棉花糖；38.小溪；39.丽人；40.咖啡；41.嫩芽；42.热情；43.渐暖；44.早餐；45.白茶；46.白嫩；47.圣代；48.森林；49.冲浪；50.奶咖；51.清澈；52.微风；53.日落；54.水光；55.日系；56.星光；57.阳光；58.落叶；59.生机；60.甜心；61.清逸；62.春意；63.罗马；64.青涩；65.清风；66.暖心；67.海水；68.神秘；69.旧调1；70.旧调2；71.雪顶；72.日光；73.浮云；74.流彩；75.胶片；76.回味；77.奶酪；78.蝴蝶。
                Image:
                  type: string
                  description: |-
                    图片 base64 数据，base64 编码后大小不可超过5M。
                    支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
                Url:
                  type: string
                  description: |-
                    图片的 Url ，对应图片 base64 编码后大小不可超过5M。
                    图片的 Url、Image必须提供一个，如果都提供，只使用 Url。
                    图片存储于腾讯云的 Url 可保障更高下载速度和稳定性，建议图片存储于腾讯云。
                    非腾讯云存储的Url速度和稳定性可能受一定影响。
                    支持PNG、JPG、JPEG、BMP 等图片格式，不支持 GIF 图片。
                FilterDegree:
                  type: number
                  description: 滤镜效果，取值[0,100]，0表示无效果，100表示满滤镜效果。默认值为80。
                RspImgType:
                  type: string
                  description: 返回图像方式（base64 或 url ) ，二选一。url有效期为1天。
              required:
                - ds_id
                - FilterType
  /1962-6:
    x-pointCode: 6
    x-mode: mapping
    x-read-timeout: 20
    x-connect-timeout: 20
    post:
      summary: 人像动漫化
      description: 本接口用于人脸融合，用户上传人脸图片，获取与模板融合后的人脸图片。原接口订购地址：https://cloud.tencent.com/product/ft
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          Response:
                            type: object
                            properties:
                              Image:
                                type: string
                                description: 返回结果为图片的地址
                              RequestId:
                                type: string
                                description: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
                              ReviewResultSet:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    "0":
                                      type: object
                                      properties:
                                        Category:
                                          type: string
                                          description: 对应的类别名称 porn, politics, terror
                                        Code:
                                          type: number
                                          description: 对应子类别状态码
                                        CodeDescription:
                                          type: string
                                          description: 对应子类别状态码信息描述
                                        Suggestion:
                                          type: string
                                          description: 此字段为保留字段，目前统一返回pass。
                                        Confidence:
                                          type: number
                                          description: 对应识别种类的置信度
                                        DetailSet:
                                          type: array
                                          items:
                                            type: object
                                            properties:
                                              "0":
                                                type: object
                                                properties:
                                                  Field:
                                                    type: string
                                                    description: 鉴政使用字段, 为职业属性,其他审核结果对应上一级category
                                                  Label:
                                                    type: string
                                                    description: 人员名称
                                                  Confidence:
                                                    type: number
                                                    description: 对应识别label的置信度
                                                  Suggestion:
                                                    type: string
                                                    description: 此字段为保留字段，目前统一返回pass。
                                          description: 审核详细内容
                                description: 鉴黄鉴政结果
                        description: 业务返回体
      operationId: 1962_6_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ds_id:
                  type: string
                  description: 数据源
                Image:
                  type: string
                  description: |-
                    图片 base64 数据，base64 编码后大小不可超过5M。
                    支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
                Url:
                  type: string
                  description: |-
                    图片的 Url ，对应图片 base64 编码后大小不可超过5M。
                    图片的 Url、Image必须提供一个，如果都提供，只使用 Url。
                    图片存储于腾讯云的 Url 可保障更高下载速度和稳定性，建议图片存储于腾讯云。
                    非腾讯云存储的Url速度和稳定性可能受一定影响。
                    支持PNG、JPG、JPEG、BMP 等图片格式，不支持 GIF 图片。
                DisableGlobalEffect:
                  type: string
                  description: 关闭全图动漫化，传入true（不分大小写）即关闭全图动漫化。
              required:
                - ds_id
  /1962-5:
    x-pointCode: 5
    x-mode: mapping
    x-read-timeout: 20
    x-connect-timeout: 20
    post:
      summary: 人脸性别转换
      description: 本接口用于人脸融合，用户上传人脸图片，获取与模板融合后的人脸图片。原接口订购地址：https://cloud.tencent.com/product/ft
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          Response:
                            type: object
                            properties:
                              Image:
                                type: string
                                description: 返回结果为图片的地址
                              RequestId:
                                type: string
                                description: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
                              ReviewResultSet:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    "0":
                                      type: object
                                      properties:
                                        Category:
                                          type: string
                                          description: 对应的类别名称 porn, politics, terror
                                        Code:
                                          type: number
                                          description: 对应子类别状态码
                                        CodeDescription:
                                          type: string
                                          description: 对应子类别状态码信息描述
                                        Suggestion:
                                          type: string
                                          description: 此字段为保留字段，目前统一返回pass。
                                        Confidence:
                                          type: number
                                          description: 对应识别种类的置信度
                                        DetailSet:
                                          type: array
                                          items:
                                            type: object
                                            properties:
                                              "0":
                                                type: object
                                                properties:
                                                  Field:
                                                    type: string
                                                    description: 鉴政使用字段, 为职业属性,其他审核结果对应上一级category
                                                  Label:
                                                    type: string
                                                    description: 人员名称
                                                  Confidence:
                                                    type: number
                                                    description: 对应识别label的置信度
                                                  Suggestion:
                                                    type: string
                                                    description: 此字段为保留字段，目前统一返回pass。
                                          description: 审核详细内容
                                description: 鉴黄鉴政结果
                        description: 业务返回体
      operationId: 1962_5_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ds_id:
                  type: string
                  description: 数据源
                Image:
                  type: string
                  description: |-
                    图片 base64 数据，base64 编码后大小不可超过5M。
                    支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
                Url:
                  type: string
                  description: |-
                    图片的 Url ，对应图片 base64 编码后大小不可超过5M。
                    图片的 Url、Image必须提供一个，如果都提供，只使用 Url。
                    图片存储于腾讯云的 Url 可保障更高下载速度和稳定性，建议图片存储于腾讯云。
                    非腾讯云存储的Url速度和稳定性可能受一定影响。
                    支持PNG、JPG、JPEG、BMP 等图片格式，不支持 GIF 图片。
                Gender:
                  type: number
                  description: 选择转换方向，0：男变女，1：女变男。
              required:
                - ds_id
                - Gender
  /1962-4:
    x-pointCode: 4
    x-mode: mapping
    x-read-timeout: 20
    x-connect-timeout: 20
    post:
      summary: 人脸年龄变化
      description: 本接口用于人脸融合，用户上传人脸图片，获取与模板融合后的人脸图片。原接口订购地址：https://cloud.tencent.com/product/ft
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          Response:
                            type: object
                            properties:
                              Image:
                                type: string
                                description: 返回结果为图片的地址
                              RequestId:
                                type: string
                                description: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
                              ReviewResultSet:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    "0":
                                      type: object
                                      properties:
                                        Category:
                                          type: string
                                          description: 对应的类别名称 porn, politics, terror
                                        Code:
                                          type: number
                                          description: 对应子类别状态码
                                        CodeDescription:
                                          type: string
                                          description: 对应子类别状态码信息描述
                                        Suggestion:
                                          type: string
                                          description: 此字段为保留字段，目前统一返回pass。
                                        Confidence:
                                          type: number
                                          description: 对应识别种类的置信度
                                        DetailSet:
                                          type: array
                                          items:
                                            type: object
                                            properties:
                                              "0":
                                                type: object
                                                properties:
                                                  Field:
                                                    type: string
                                                    description: 鉴政使用字段, 为职业属性,其他审核结果对应上一级category
                                                  Label:
                                                    type: string
                                                    description: 人员名称
                                                  Confidence:
                                                    type: number
                                                    description: 对应识别label的置信度
                                                  Suggestion:
                                                    type: string
                                                    description: 此字段为保留字段，目前统一返回pass。
                                          description: 审核详细内容
                                description: 鉴黄鉴政结果
                        description: 业务返回体
      operationId: 1962_4_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ds_id:
                  type: string
                  description: 数据源
                Image:
                  type: string
                  description: |-
                    图片 base64 数据，base64 编码后大小不可超过5M。
                    支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
                Url:
                  type: string
                  description: |-
                    图片的 Url ，对应图片 base64 编码后大小不可超过5M。
                    图片的 Url、Image必须提供一个，如果都提供，只使用 Url。
                    图片存储于腾讯云的 Url 可保障更高下载速度和稳定性，建议图片存储于腾讯云。
                    非腾讯云存储的Url速度和稳定性可能受一定影响。
                    支持PNG、JPG、JPEG、BMP 等图片格式，不支持 GIF 图片。
                Age:
                  type: number
                  description: 人脸变老变年轻信息。
              required:
                - ds_id
                - Age
  /1962-3:
    x-pointCode: 3
    x-mode: mapping
    x-read-timeout: 20
    x-connect-timeout: 20
    post:
      summary: 人脸美颜
      description: 本接口用于人脸融合，用户上传人脸图片，获取与模板融合后的人脸图片。接口订购地址：https://cloud.tencent.com/product/fmu
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          Response:
                            type: object
                            properties:
                              Image:
                                type: string
                                description: 返回结果为图片的地址
                              RequestId:
                                type: string
                                description: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
                              ReviewResultSet:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    "0":
                                      type: object
                                      properties:
                                        Category:
                                          type: string
                                          description: 对应的类别名称 porn, politics, terror
                                        Code:
                                          type: number
                                          description: 对应子类别状态码
                                        CodeDescription:
                                          type: string
                                          description: 对应子类别状态码信息描述
                                        Suggestion:
                                          type: string
                                          description: 此字段为保留字段，目前统一返回pass。
                                        Confidence:
                                          type: number
                                          description: 对应识别种类的置信度
                                        DetailSet:
                                          type: array
                                          items:
                                            type: object
                                            properties:
                                              "0":
                                                type: object
                                                properties:
                                                  Field:
                                                    type: string
                                                    description: 鉴政使用字段, 为职业属性,其他审核结果对应上一级category
                                                  Label:
                                                    type: string
                                                    description: 人员名称
                                                  Confidence:
                                                    type: number
                                                    description: 对应识别label的置信度
                                                  Suggestion:
                                                    type: string
                                                    description: 此字段为保留字段，目前统一返回pass。
                                          description: 审核详细内容
                                description: 鉴黄鉴政结果
                        description: 业务返回体
      operationId: 1962_3_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ds_id:
                  type: string
                  description: 数据源
                Image:
                  type: string
                  description: |-
                    图片 base64 数据，base64 编码后大小不可超过5M。
                    支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
                Url:
                  type: string
                  description: |-
                    图片的 Url 。对应图片 base64 编码后大小不可超过5M。
                    Url、Image必须提供一个，如果都提供，只使用 Url。
                    图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
                    非腾讯云存储的Url速度和稳定性可能受一定影响。
                    支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
                Whitening:
                  type: number
                  description: 美白程度，取值范围[0,100]。0不美白，100代表最高程度。默认值30。
                Smoothing:
                  type: number
                  description: 磨皮程度，取值范围[0,100]。0不磨皮，100代表最高程度。默认值10。
                FaceLifting:
                  type: number
                  description: 瘦脸程度，取值范围[0,100]。0不瘦脸，100代表最高程度。默认值70。
                EyeEnlarging:
                  type: number
                  description: 大眼程度，取值范围[0,100]。0不大眼，100代表最高程度。默认值70。
                RspImgType:
                  type: string
                  description: 返回图像方式（base64 或 url ) ，二选一。url有效期为1天。
              required:
                - ds_id
  /1962-2:
    x-pointCode: 2
    x-mode: mapping
    x-read-timeout: 20
    x-connect-timeout: 20
    post:
      summary: 图片滤镜
      description: 本接口用于人脸融合，用户上传人脸图片，获取与模板融合后的人脸图片。原接口订购地址：https://cloud.tencent.com/product/fmu
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          Response:
                            type: object
                            properties:
                              ResultImage:
                                type: string
                                description: |-
                                  RspImgType 为 base64 时，返回处理后的图片 base64 数据。默认返回base64
                                  注意：此字段可能返回 null，表示取不到有效值。
                              ResultUrl:
                                type: string
                                description: |-
                                  RspImgType 为 url 时，返回处理后的图片 url 数据。
                                  注意：此字段可能返回 null，表示取不到有效值。
                              RequestId:
                                type: string
                                description: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
                          ret_code:
                            type: number
                        description: 业务返回体
      operationId: 1962_2_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ds_id:
                  type: string
                  description: 数据源
                FilterType:
                  type: number
                  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.午后。
                Image:
                  type: string
                  description: |-
                    图片 base64 数据，base64 编码后大小不可超过5M。
                    支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
                Url:
                  type: string
                  description: |-
                    图片的 Url ，对应图片 base64 编码后大小不可超过5M。
                    图片的 Url、Image必须提供一个，如果都提供，只使用 Url。
                    图片存储于腾讯云的 Url 可保障更高下载速度和稳定性，建议图片存储于腾讯云。
                    非腾讯云存储的Url速度和稳定性可能受一定影响。
                    支持PNG、JPG、JPEG、BMP 等图片格式，不支持 GIF 图片。
                FilterDegree:
                  type: number
                  description: 滤镜效果，取值[0,100]，0表示无效果，100表示满滤镜效果。默认值为80。
                RspImgType:
                  type: string
                  description: 返回图像方式（base64 或 url ) ，二选一。url有效期为1天。
              required:
                - ds_id
                - FilterType
  /1962-1:
    x-pointCode: 1
    x-mode: mapping
    x-read-timeout: 20
    x-connect-timeout: 20
    post:
      summary: 人脸融合
      description: |-
        Version=2018-12-01
        本接口用于人脸融合，用户上传人脸图片，获取与模板融合后的人脸图片。原接口订购地址：https://cloud.tencent.com/product/facefusion
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          Response:
                            type: object
                            properties:
                              Image:
                                type: string
                                description: 返回结果为图片的地址
                              RequestId:
                                type: string
                                description: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
                              ReviewResultSet:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    "0":
                                      type: object
                                      properties:
                                        Category:
                                          type: string
                                          description: 对应的类别名称 porn, politics, terror
                                        Code:
                                          type: number
                                          description: 对应子类别状态码
                                        CodeDescription:
                                          type: string
                                          description: 对应子类别状态码信息描述
                                        Suggestion:
                                          type: string
                                          description: 此字段为保留字段，目前统一返回pass。
                                        Confidence:
                                          type: number
                                          description: 对应识别种类的置信度
                                        DetailSet:
                                          type: array
                                          items:
                                            type: object
                                            properties:
                                              "0":
                                                type: object
                                                properties:
                                                  Field:
                                                    type: string
                                                    description: 鉴政使用字段, 为职业属性,其他审核结果对应上一级category
                                                  Label:
                                                    type: string
                                                    description: 人员名称
                                                  Confidence:
                                                    type: number
                                                    description: 对应识别label的置信度
                                                  Suggestion:
                                                    type: string
                                                    description: 此字段为保留字段，目前统一返回pass。
                                          description: 审核详细内容
                                description: 鉴黄鉴政结果
                        description: 业务返回体
      operationId: 1962_1_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                ds_id:
                  type: string
                  description: 数据源
                ProjectId:
                  type: string
                  description: 活动 ID，请在腾讯云人脸融合控制台查看。
                ModelId:
                  type: string
                  description: 素材 ID，请在腾讯云人脸融合控制台查看。
                RspImgType:
                  type: string
                  description: 返回图像方式（url 或 base64) ，二选一。url有效期为7天。
                Image:
                  type: string
                  description: 图片 base64 数据。请确保人脸为正脸，无旋转。若某些手机拍摄后人脸被旋转，请使用图片的 EXIF 信息对图片进行旋转处理；请勿在 base64 数据中包含头部，如“data:image/jpeg;base64,”。
                Url:
                  type: string
                  description: 图片Url地址
                CelebrityIdentify:
                  type: number
                  description: |-
                    0表示不需要不适宜内容识别，1表示需要不适宜内容识别。默认值为0。
                    请注意，不适宜内容识别服务开启后，您需要根据返回结果自行判断是否调整您的业务逻辑。例如提示您的用户图片非法，请更换图片。
              required:
                - ds_id
                - ProjectId
                - ModelId
                - RspImgType
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/1962?tab=book
x-apiCode: "1962"
x-is-own: false
x-is-op: true
