Go SDK

前提条件

• 已创建并获取AccessKey。具体操作，请参见创建AccessKey。
• 已开通OSS服务、创建存储空间并上传文件到存储空间。具体操作，请参见控制台上传文件。
• 已开通智能媒体管理服务。具体操作，请参见开通产品。
• 已通过智能媒体管理控制台创建项目。具体操作，请参见创建项目。
  说明

  • 您也可以调用API接口创建项目。具体操作，请参见CreateProject - 创建项目。
  • 您可以调用ListProjects - 列出所有项目信息的列表接口列出指定地域下已创建的所有项目信息。

安装SDK

使用方法

如下以在华东1（杭州）地域中检测图片中的人脸及人脸信息为例介绍如何使用智能媒体管理Go SDK。

1. 创建main.go文件并写入如下内容。

   说明

   复制使用如下示例代码时请将访问域名换成您的IMM项目所在Region的域名，并且IMM项目和OSS文件Region需要保持一致。

   package main
   import (
      "fmt"
      "os"
      openapi "github.com/alibabacloud-go/darabonba-openapi/client"
      imm "github.com/alibabacloud-go/imm-20200930/client"
      "github.com/alibabacloud-go/tea/tea"
   )
   func main() {
      // 初始化IMM客户端。
      // 阿里云账号AccessKey拥有所有API的访问权限，建议您使用RAM用户进行API访问或日常运维。
      // 强烈建议不要把AccessKey ID和AccessKey Secret保存到工程代码里，否则可能导致AccessKey泄露，威胁您账号下所有资源的安全。
      // 本示例通过从环境变量中读取AccessKey，来实现API访问的身份验证。如何配置环境变量，请参见https://help.aliyun.com/document_detail/2361894.html。
      immClient, err := imm.NewClient(&openapi.Config{
         RegionId: tea.String("cn-hangzhou"),                   // 填写项目所在地域ID。
         AccessKeyId: tea.String(os.Getenv("AccessKeyId")),         
         AccessKeySecret: tea.String(os.Getenv("AccessKeySecret")), 
      })
      if err != nil {
         // 错误处理。
         panic(err)
      }
      // 填写项目名称。
      projectName := "imm-go-sdk-doc-demo"
      // 填写图片的OSS URI。
      sourceUri := "oss://your-bucket-name/your-path/your-image.jpg"
      // 构造检测图片中的人脸及人脸信息请求。
      detectImageFacesRequest := &imm.DetectImageFacesRequest{
         ProjectName: tea.String(projectName),
         SourceURI:   tea.String(sourceUri),
      }
      // 发起请求。
      detectImageFacesResp, err := immClient.DetectImageFaces(detectImageFacesRequest)
      if err != nil {
         // 错误处理。
         fmt.Println(err)
         return
      }
      // 打印响应结果Body信息。
      fmt.Println(detectImageFacesResp.Body.String())
   }

2. 执行go run main.go命令，控制台输出结果如下。

   {
      "Faces": [
         {
            "Age": 25,
            "AgeSD": 7,
            "Attractive": 0.998,
            "Beard": "none",
            "BeardConfidence": 1,
            "Boundary": {
               "Height": 127,
               "Left": 81,
               "Top": 62,
               "Width": 96
            },
            "Emotion": "happiness",
            "EmotionConfidence": 0.999,
            "FaceQuality": 0.998,
            "FigureClusterId": "figure-cluster-id-unavailable",
            "FigureConfidence": 0.999,
            "FigureId": "30f18b25-db81-4dc6-8461-fd63ab0ef16d",
            "FigureType": "face",
            "Gender": "female",
            "GenderConfidence": 1,
            "Glasses": "none",
            "GlassesConfidence": 1,
            "Hat": "none",
            "HatConfidence": 1,
            "HeadPose": {
               "Pitch": -16.989,
               "Roll": 6.006,
               "Yaw": 7.47
            },
            "Mask": "none",
            "MaskConfidence": 0.83,
            "Mouth": "open",
            "MouthConfidence": 0.998,
            "Sharpness": 1
         }
      ],
      "RequestId": "28084591-0A06-0981-9AD5-B0FBD0967FD7"
   }