腾讯云-人脸特效

连接器

需两次购买：①订购原厂商接口 ②订购易源会员包代理转发；人脸融合是依托人脸识别算法和深度学习引擎的面部融合技术，能够快速精准地定位人脸关键点，将用户上传的照片与特定形象进行面部层面融合，使生成的图片同时具备用户与特定形象的外貌特征。

大厂接口

会员资源包统一计费，无需单独购买，开通会员包后可直接调用。

人脸融合

接入点说明

Version=2018-12-01
本接口用于人脸融合，用户上传人脸图片，获取与模板融合后的人脸图片。原接口订购地址：https://cloud.tencent.com/product/facefusion

接口地址

https://connector.showapi.com/1962-1?appKey={your_appKey}查看密钥调用帮助

返回格式JSON

请求方式POST/GET

请求参数

Header 参数

参数名称	类型	示例值	必须	描述
content-type	String	application/x-www-form-urlencoded	否

Post 表单

参数名称	类型	示例值	必须	描述
ds_id	String	-	是	数据源
ProjectId	String	104578	是	活动 ID，请在腾讯云人脸融合控制台查看。
ModelId	String	qc_104578_164225_2	是	素材 ID，请在腾讯云人脸融合控制台查看。
RspImgType	String	url	是	返回图像方式（url 或 base64) ，二选一。url有效期为7天。
Image	String	-	否	图片 base64 数据。请确保人脸为正脸，无旋转。若某些手机拍摄后人脸被旋转，请使用图片的 EXIF 信息对图片进行旋转处理；请勿在 base64 数据中包含头部，如“data:image/jpeg;base64,”。
Url	String	https://showapi-pub-shanghai.oss-cn-shanghai.aliyuncs.com/api/3040/example/1690878628_142.png	否	图片Url地址
CelebrityIdentify	Number	-	否	0表示不需要不适宜内容识别，1表示需要不适宜内容识别。默认值为0。请注意，不适宜内容识别服务开启后，您需要根据返回结果自行判断是否调整您的业务逻辑。例如提示您的用户图片非法，请更换图片。

返回参数

该接口返回经 showapi_res_body 系统封装，业务数据均位于该对象内；系统级字段见。

返回体

请求示例

查看我的 appKey 查看使用向导

Python / Java 等多语言示例

cURL

curl -X POST "https://connector.showapi.com/1962-1?appKey=YOUR_APPKEY" \
  -H "content-type: application/x-www-form-urlencoded" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "ds_id=&ProjectId=104578&ModelId=qc_104578_164225_2&RspImgType=url&Image=&Url=https%3A%2F%2Fshowapi-pub-shanghai.oss-cn-shanghai.aliyuncs.com%2Fapi%2F3040%2Fexample%2F1690878628_142.png&CelebrityIdentify="

返回示例

JSON

{
    "showapi_res_error":"",
    "showapi_res_id":"fcf03b4fc1f24ecdab580befbfcf2efe",
    "showapi_res_code":0,
    "showapi_res_body":{
        "Response":{
            "Image":"https://facefusion-1254418846.cos.ap-guangzhou.myqcloud.com/qc_100646_204857_1_1543312645513131155.jpg",
            "RequestId":"66676130-5588-4cdb-a81e-8bd3c99cea1f",
            "ReviewResultSet":[
                {
                    "Category":"porn",
                    "Code":0,
                    "CodeDescription":"ok",
                    "Suggestion":"pass",
                    "Confidence":0.000022541460566572,
                    "DetailSet":[
                        {
                            "Field":"porn",
                            "Label":"porn",
                            "Confidence":1.9030628184424e-9,
                            "Suggestion":"pass"
                        }
                    ]
                },
                {
                    "Category":"politics",
                    "Code":0,
                    "CodeDescription":"ok",
                    "Suggestion":"pass",
                    "Confidence":0.71566122770309,
                    "DetailSet":[
                        {
                            "Field":"体育",
                            "Lable":"丁俊晖",
                            "Confidence":0.71566122770309,
                            "Suggestion":"pass"
                        }
                    ]
                }
            ]
        }
    }
}

MCP 服务集成接口级

在 Cherry Studio、ChatBox 等支持 MCP 的客户端中配置，将 {your_appKey} 替换为真实 AppKey（AppKey 管理）。该服务覆盖本接口全部接入点。

MCP JSON

{
  "mcpServers": {
    "showapi-mcp-1962": {
      "url": "http://www.showapi.com.cn/mcp/1962/{your_appKey}"
    }
  }
}

OpenAPI 文档接口级

标准 OpenAPI 3.0 文档，覆盖本接口全部接入点，可导入 Apifox / Postman / Swagger UI，或供 AI Agent 直接消费。

在线查看 YAML

下载 YAML

查看 JSON