人像特效处理

官方自营

是一个全面的美容和编辑平台，旨在为开发者提供精准高效的人脸识别和图像处理技术。通过我们强大的API和SDK，用户可以轻松实现对面部特征、人像整体外观以及年龄和性别属性的细致调整。这不仅限于日常的图片美化，我们的技术还能够支持更专业的应用场景，如在线证件照制作、社交平台头像定制等。

生活娱乐变装人脸合成技术证件照处理照片处理

已选规格

￥50.00元

自购买起有效期 12 个月

专用资源包

支持通用资源包：充值通用资源包后可直接调用含本接口在内的全站付费接口，无需单独购买专用资源包去充值 ›

证件照换装

接入点说明

证件照换装API，原【证件照换装_下载】接入点，现已取消预览功能，可用原【证件照换装_预览】接入点的请求参数调用该接入点

接口地址

https://route.showapi.com/2673-20?appKey={your_appKey}查看密钥调用帮助

返回格式JSON

请求方式POST/GET

请求参数

Header 参数

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

Post 表单

参数名称	类型	示例值	必须	描述
img_base64	String	-	否	原始证件照文件的Base64编码字符串（不需要base64标签头），建议大小不超过1.5M，像素不低于背景要求像素，照片中的人物需暴露出双耳，和img_url参数二选一入参，支持jpg、png格式。
img_url	String	https://showapi-pub-shanghai.oss-cn-shanghai.aliyuncs.com/api/2673/dz_20211117094642.jpg	否	原始证件照文件的URL，建议大小不超过1.5M，像素不低于背景要求像素，照片中的人物需暴露出双耳，和img_base64参数二选一入参，支持jpg、png格式。
color	String	-	否	背景颜色（不传将启用模板默认背景色，参考【背景模板查询】），支持white,turquoise,blue,red,darkblue五种颜色，分别对应RG:FFFFFF、56BCEE、588DD5、E93223、2D3A59
clothes_num	String	m1	是	要换装的衣服编码，共有三大系列，几十套衣服。详情参考帮助手册
code	String	1350	是	背景模板编码，参考【背景模板查询】

返回参数

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

返回体

请求示例

查看我的 appKey 查看使用向导

Python / Java 等多语言示例

cURL

curl -X POST "https://route.showapi.com/2673-20?appKey=YOUR_APPKEY" \
  -H "content-type: application/x-www-form-urlencoded" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "img_base64=&img_url=https%3A%2F%2Fshowapi-pub-shanghai.oss-cn-shanghai.aliyuncs.com%2Fapi%2F2673%2Fdz_20211117094642.jpg&color=&clothes_num=m1&code=1350"

返回示例

JSON

{
  "showapi_res_id": "",
  "showapi_res_error": "",
  "showapi_res_code": 0,
  "showapi_res_body": {
		"ret_code":0,
    "url":""
  }
}

MCP 服务集成接口级

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

MCP JSON

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

OpenAPI 文档接口级

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

在线查看 YAML

下载 YAML

查看 JSON