文档

Go SDK

更新时间:

阿里云API调试工具OpenAPI Explore提供OpenAPI文档、API调试和SDK示例,帮助您快速入门API开发。本文介绍如何安装和快速使用智能媒体管理Go SDK。

前提条件

安装SDK

重要

调用2020-09-30版本的API,需要使用2020-09-30版本的SDK。

使用智能媒体管理Go 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"
    }            
  • 本页导读 (1)
文档反馈