八年程序员带你实现古风视频换脸：入门教程二

1. 接口描述

接口请求域名： https://ai.ncmyt.cn/api/faceVideo/queryTemplateType

本接口用于获取制作换脸的视频模板分类列表，如：古风汉服、气质美女、最美旗袍、56个民族、男士专属、骑马等

2. 输入参数

以下请求参数列表列出了接口请求参数和部分公共参数

参数名称	必选	类型	描述	示例
appKey	是	String	用于加密签名字符串和服务器端验证签名字符串的密钥。 用户必须严格保管安全凭证，避免泄露。	示例值
version	是	String	版本号，固定值	1.0.0
timestamp	是	String	当前时间戳	1515722592
sign	是	String	签名,加密规则见下面	9BF3162452BBD9736A18EE44EF895DC3

3. 输出参数

参数名称	类型	描述	示例
data	String	返回结果的base64编码数据（需开发者自行解码）	见示例
status	String	返回"ok",表示请求成功。返回"error"，则表示请求失败	ok
tipMsg	String	请求返回提示语	请求成功
type	String	视频模板类型	1
name	String	视频模板类型名称	古风汉服

4. 示例

请求成功示例

{
    "data": "W3sidHlwZSI6IjEiLCJuYW1lIjoi5pyA576O5peX6KKNIn0seyJ0eXBlIjoiMiIsIm5hbWUiOiI1NuS4quawkeaXjyJ9LHsidHlwZSI6IjMiLCJuYW1lIjoi5Y+k6KOF5rGJ5pyNIn0seyJ0eXBlIjoiNCIsIm5hbWUiOiLogozogonnsr7pkqIifSx7InR5cGUiOiI1IiwibmFtZSI6IuWJp+aDhSJ9LHsidHlwZSI6IjYiLCJuYW1lIjoi55S35aOr5LiT5bGeIn0seyJ0eXBlIjoiNyIsIm5hbWUiOiLpqpHpqawifSx7InR5cGUiOiI4IiwibmFtZSI6IuawlOi0qOe+juWlsyJ9LHsidHlwZSI6IjkiLCJuYW1lIjoi5ama57qxIn1d",
    "status": "ok",
    "tipMsg": "查询成功！"
}

数据解码示例

[{
	"type": "1",
	"name": "最美旗袍"
}, {
	"type": "2",
	"name": "56个民族"
}, {
	"type": "3",
	"name": "古装汉服"
}, {
	"type": "4",
	"name": "肌肉精钢"
}, {
	"type": "5",
	"name": "剧情"
}, {
	"type": "6",
	"name": "男士专属"
}, {
	"type": "7",
	"name": "骑马"
}, {
	"type": "8",
	"name": "气质美女"
}, {
	"type": "9",
	"name": "婚纱"
}]

请求失败示例

{
    "status": "error",
    "tipMsg": "非法请求或版本过低，请更新至最新版本"
}

DEMO示例（JAVA）

public static void testQueryTemplateType() {
    //API请求地址
    String url = "https://ai.ncmyt.cn/api/faceVideo/queryTemplateType";

    //API请求参数
    Map params = new HashMap<>();

    //1、公共请求参数
    params.put("appKey", appKey);
    params.put("timestamp", System.currentTimeMillis() + "");
    params.put("version", "1.0.1");

    //2、业务请求参数

    //计算sign
    String sign = createSign(params, appSceret);
    params.put("sign", sign);

    //3、发起POST请求
    try {
        String reqResult = sendHttpPostRequest(url, params);
        JSonObject jsonObject = JSON.parseObject(reqResult);
        String data = jsonObject.getString("data");
        String status = jsonObject.getString("status");
        if (StringUtils.isNotBlank(status) && status.equalsIgnoreCase("ok")) {
            if (StringUtils.isNotBlank(data)) {
                data = base64Decode(data);//进行base64解密，得到JSON字符串
            }
            System.out.println("模版分类列表：" + data);
        }
    } catch (Exception e) {
        e.printStackTrace();
    }
}