手把手教你接入人脸核身：从零到上线完整教程

用户 → App → 业务服务端 → 慧眼服务端
  ↓        ↓           ↓
触发核身  请求Token   调用GetFaceIdToken
  ↓        ↓           ↓
收到Token ← 返回Token ← 返回SdkToken
  ↓
启动SDK(startHuiYanAuth)
  ↓
活体检测+人脸比对
  ↓
SDK回调通知结果
  ↓
业务服务端拉取结果(GetFaceIdResult)
  ↓
展示核身结果

package main

import (
    "encoding/json"
    "log"
    "net/http"

    "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common"
    "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/common/profile"
    faceid "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/faceid/v20180301"
)

var FaceIdClient *faceid.Client

func init() {
    prof := profile.NewClientProfile()
    prof.HttpProfile.ReqTimeout = 60
    // 替换成你的 SecretId 和 SecretKey
    credential := common.NewCredential("SecretId", "SecretKey")
    var err error
    FaceIdClient, err = faceid.NewClient(credential, "ap-guangzhou", prof)
    if err != nil {
        log.Fatal("FaceIdClient init error: ", err)
    }
}

// GetFaceIdToken 获取人脸核身 Token
func GetFaceIdTokenHandler(w http.ResponseWriter, r *http.Request) {
    r.ParseForm()
    compareLib := r.FormValue("CompareLib")

    request := faceid.NewGetFaceIdTokenRequest()
    request.CompareLib = &compareLib

    response, err := FaceIdClient.GetFaceIdToken(request)
    if err != nil {
        w.Write([]byte("error: " + err.Error()))
        return
    }

    result := map[string]string{
        "FaceIdToken": *response.Response.FaceIdToken,
    }
    json.NewEncoder(w).Encode(result)
}

// GetFaceIdResult 获取核身结果
func GetFaceIdResultHandler(w http.ResponseWriter, r *http.Request) {
    r.ParseForm()
    faceIdToken := r.FormValue("FaceIdToken")

    request := faceid.NewGetFaceIdResultRequest()
    request.FaceIdToken = &faceIdToken

    response, err := FaceIdClient.GetFaceIdResult(request)
    if err != nil {
        w.Write([]byte("error: " + err.Error()))
        return
    }

    result := map[string]string{
        "Result": *response.Response.Result,
    }
    json.NewEncoder(w).Encode(result)
}

import com.tencentcloudapi.common.Credential;
import com.tencentcloudapi.common.profile.ClientProfile;
import com.tencentcloudapi.common.profile.HttpProfile;
import com.tencentcloudapi.faceid.v20180301.FaceidClient;
import com.tencentcloudapi.faceid.v20180301.models.*;

public class FaceIdService {

    private static final String SECRET_ID = "你的SecretId";
    private static final String SECRET_KEY = "你的SecretKey";
    private static final String REGION = "ap-guangzhou";

    public static FaceidClient getClient() {
        Credential cred = new Credential(SECRET_ID, SECRET_KEY);
        HttpProfile httpProfile = new HttpProfile();
        httpProfile.setReqMethod("POST");
        ClientProfile clientProfile = new ClientProfile();
        clientProfile.setHttpProfile(httpProfile);
        return new FaceidClient(cred, REGION, clientProfile);
    }

    // 获取 FaceIdToken
    public static String getFaceIdToken(String compareLib) throws Exception {
        FaceidClient client = getClient();
        GetFaceIdTokenRequest req = new GetFaceIdTokenRequest();
        req.setCompareLib(compareLib);
        GetFaceIdTokenResponse resp = client.GetFaceIdToken(req);
        return resp.getFaceIdToken();
    }

    // 获取核身结果
    public static String getFaceIdResult(String faceIdToken) throws Exception {
        FaceidClient client = getClient();
        GetFaceIdResultRequest req = new GetFaceIdResultRequest();
        req.setFaceIdToken(faceIdToken);
        GetFaceIdResultResponse resp = client.GetFaceIdResult(req);
        return resp.getResult();
    }
}

import json
from tencentcloud.common import credential
from tencentcloud.common.profile.client_profile import ClientProfile
from tencentcloud.common.profile.http_profile import HttpProfile
from tencentcloud.faceid.v20180301 import faceid_client, models

class FaceIdService:
    def __init__(self, secret_id, secret_key, region="ap-guangzhou"):
        self.cred = credential.Credential(secret_id, secret_key)
        self.region = region
        http_profile = HttpProfile()
        http_profile.reqMethod = "POST"
        client_profile = ClientProfile()
        client_profile.httpProfile = http_profile
        self.client = faceid_client.FaceidClient(self.cred, region, client_profile)

    def get_face_id_token(self, compare_lib="LIBRARY"):
        req = models.GetFaceIdTokenRequest()
        req.CompareLib = compare_lib
        resp = self.client.GetFaceIdToken(req)
        return resp.FaceIdToken

    def get_face_id_result(self, face_id_token):
        req = models.GetFaceIdResultRequest()
        req.FaceIdToken = face_id_token
        resp = self.client.GetFaceIdResult(req)
        return resp.Result

# 使用示例
if __name__ == "__main__":
    service = FaceIdService("你的SecretId", "你的SecretKey")
    token = service.get_face_id_token()
    print(f"Token: {token}")
    # result = service.get_face_id_result(token)
    # print(f"Result: {result}")