人脸识别服务 FRS-Go SDK:开始使用

时间:2024-05-14 09:24:37

开始使用

详细的SDK介绍请参见SDK中心Go SDK使用指导Go SDK使用视频

  1. 导入依赖模块
    import (
    	"fmt"
            "os"
    	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    
        // 导入v2版本sdk
        frs "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/frs/v2"
    	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/frs/v2/model"
        region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/frs/v2/region"
    )
  2. 配置认证信息
    配置AK、SK信息。华为云通过AK识别用户的身份,通过SK对请求数据进行签名验证,用于确保请求的机密性、完整性和请求者身份的正确性。AK、SK获取方法请参见准备工作
    func GetCredential(ak, sk string) basic.Credentials {
    	// Init Auth Info
    	return basic.NewCredentialsBuilder().
    		WithAk(ak).
    		WithSk(sk).
    		Build()
    }

    初始化认证信息:

    ak := os.Getenv("HUAWEICLOUD_SDK_AK")
    sk := os.Getenv("HUAWEICLOUD_SDK_SK")
    client := GetCredential(ak, sk)
    • 认证用的 ak 和sk 硬编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全。
    • 本示例以 ak 和 sk 保存在环境变量中来实现身份验证为例,运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。
    图3 Windows环境新建环境变量
  3. 初始化客户端
    指定region方式
    // # 初始化人脸识别服务的客户端,并选择服务部署区域
    func GetClient(auth basic.Credentials) *frs.FrsClient {
    	client := frs.NewFrsClient(
    			frs.FrsClientBuilder().
    			WithRegion(region.ValueOf('cn-north-4')).
    			WithCredential(auth).
    			Build())
            return client
    }

    服务部署区域请参见终端节点

  4. 发送请求并查看下响应
    request := &model.DetectFaceByBase64Request{}
    request.Body = &model.FaceDetectBase64Req{
    	ImageBase64: "/9j/4AAQSkZJRgABAQAAAQABAAD...",
    }
    response, err := client.DetectFaceByBase64(request)
    if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }

    使用人脸比对SDK时,image1、image2参数需为相同类型,即同为url、base64或file。

  5. 异常处理
    表1 异常处理

    一级分类

    一级分类说明

    ServiceResponseError

    服务响应异常

    url.Error

    url异常

    // 捕获和处理不同类型的异常
    response, err := client.DetectFaceByBase64(request)
    if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
support.huaweicloud.com/sdkreference-face/face_04_0022.html