# Generated by ShowAPI OpenAPI generator # source: market/1962 # generated-at: 2026-09-04T22:52:13.376Z 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: false