Intelligent Media Management:Go 用 IMM SDK

Go 用 IMM SDK のインストール方法の詳細については、クイックスタートを参照してください。

package main

import (
	"fmt"
	"github.com/alibabacloud-go/tea/tea"
	"os"

	openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
	imm "github.com/alibabacloud-go/imm-20200930/v4/client"
	sts20150401 "github.com/alibabacloud-go/sts-20150401/v2/client"
)

func main() {
	// STS クライアントを作成し、AssumeRole オペレーションを呼び出して STS トークンを取得します。
	stsConfig := &openapi.Config{}
	stsConfig.SetAccessKeyId(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
	stsConfig.SetAccessKeySecret(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"))
	stsConfig.SetEndpoint("sts.cn-beijing.aliyuncs.com")
	stsClient, _err := sts20150401.NewClient(stsConfig)
	if _err != nil {
		panic(_err)
	}

	// AssumeRole オペレーションを呼び出して、STS トークンを取得します。
	assumeRoleRequest := &sts20150401.AssumeRoleRequest{
		RoleArn:         tea.String("acs:ram::125499367423****:role/STStokenTestRole"),
		RoleSessionName: tea.String("STSsessionName"),
		DurationSeconds: tea.Int64(3600),
	}
	assumeRoleResp, err := stsClient.AssumeRole(assumeRoleRequest)
	if err != nil {
		panic(err)
	}

	// STS トークンを使用して IMM クライアントを作成します。
	immConfig := &openapi.Config{
		AccessKeyId:     assumeRoleResp.Body.Credentials.AccessKeyId,
		AccessKeySecret: assumeRoleResp.Body.Credentials.AccessKeySecret,
		SecurityToken:   assumeRoleResp.Body.Credentials.SecurityToken,
		Endpoint:        tea.String("imm.cn-beijing.aliyuncs.com"),
	}

	immClient, err := imm.NewClient(immConfig)
	if err != nil {
		panic(err)
	}

	// 画像から顔と顔情報を検出するリクエストを構築します。
	projectName := "imm-go-sdk-doc-demo"
	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
	}

	// レスポンスボディを表示します。
	fmt.Println(detectImageFacesResp.Body.String())
}

次の例では、Go 用 IMM SDK を使用して顔を検出し、中国 (杭州) リージョンの画像から顔情報を取得する方法について説明します。

1. main.go ファイルを作成し、次のコードをファイルに書き込みます。

   package main
   import (
      "fmt"
      "os"
      openapi  "github.com/alibabacloud-go/darabonba-openapi/v2/client"
      imm "github.com/alibabacloud-go/imm-20200930/v4/client"
      "github.com/alibabacloud-go/tea/tea"
   )
   func main() {
      // IMM クライアントを初期化します。
      // Alibaba Cloud アカウントの AccessKey ペアは、すべての API オペレーションに対する権限を持っています。RAM ユーザーを使用して API オペレーションを呼び出したり、日常的な O&M を実行することをお勧めします。
      // セキュリティ上の理由から、AccessKey ペアをコードに埋め込まないことをお勧めします。
      // この例では、AccessKey ペアは環境変数から取得されます。環境変数の構成方法の詳細については、https://help.aliyun.com/document_detail/2361894.html を参照してください。
      immClient, err := imm.NewClient(&openapi.Config{
         RegionId: tea.String("cn-beijing"),                   // リージョン ID を指定します。
         AccessKeyId: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),         
         AccessKeySecret: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")), 
      })
      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
      }
      // レスポンスボディを出力します。
      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"
   }