すべてのプロダクト
Search
ドキュメントセンター

Intelligent Media Services:AI を使用したメディアアセットコンテンツの理解

最終更新日:Dec 05, 2025

Intelligent Media Services (IMS) を使用すると、動画、音声、画像などのメディアアセットのコンテンツを理解できます。 必要に応じて特定のアセットを分析できます。 このトピックでは、OpenAPI 操作を呼び出してコンテンツ理解を実行する方法について説明します。

前提条件

  • IMS が有効化されていること。 詳細については、「サービスの有効化」をご参照ください。

  • IMS のサーバーサイドソフトウェア開発キット (SDK) がインストールされていること。 詳細については、「SDK のインストール」をご参照ください。

基本的な使用方法

  1. インテリジェントコンテンツ理解アルゴリズムテンプレートの作成

    CreateCustomTemplate API 操作を呼び出して、カスタム AI ベースのインテリジェント分析テンプレートを作成できます。

    サンプルコード:

    # -*- coding: utf-8 -*-
    from alibabacloud_ice20201109.client import Client as ICE20201109Client
    from alibabacloud_credentials.client import Client as CredentialClient
    from alibabacloud_tea_openapi import models as open_api_models
    from alibabacloud_ice20201109 import models as ice20201109_models
    from alibabacloud_tea_util import models as util_models
    
    # 本番環境では、RAM ロールなどのより安全な認証方式を使用することを推奨します。 認証情報の設定方法の詳細については、https://www.alibabacloud.com/help/document_detail/378659.html をご参照ください。
    credential = CredentialClient()
    config = open_api_models.Config(
        credential=credential
    )
    # エンドポイントについては、https://api.aliyun.com/product/ICE をご参照ください。
    config.endpoint = 'ice.cn-xxx.aliyuncs.com'
    client = ICE20201109Client(config)
    
    create_custom_template_request = ice20201109_models.CreateCustomTemplateRequest(
        name='face_template_001',
        template_config='{"AnalyseTypes":"face","FaceCategoryIds":"celebrity,politician,sensitive"}',
        type=11
    )
    runtime = util_models.RuntimeOptions()
    response = client.create_custom_template_with_options(create_custom_template_request, runtime)
    print(response)
  2. インテリジェントコンテンツ理解ジョブの送信

    SubmitSmarttagJob API 操作を呼び出して、インテリジェントコンテンツ理解ジョブを送信できます。

    サンプルコード:

    # -*- coding: utf-8 -*-
    from alibabacloud_ice20201109.client import Client as ICE20201109Client
    from alibabacloud_credentials.client import Client as CredentialClient
    from alibabacloud_tea_openapi import models as open_api_models
    from alibabacloud_ice20201109 import models as ice20201109_models
    from alibabacloud_tea_util import models as util_models
    
    # 本番環境では、RAM ロールなどのより安全な認証方式を使用することを推奨します。 認証情報の設定方法の詳細については、https://www.alibabacloud.com/help/document_detail/378659.html をご参照ください。
    credential = CredentialClient()
    config = open_api_models.Config(
        credential=credential
    )
    # エンドポイントについては、https://api.aliyun.com/product/ICE をご参照ください。
    config.endpoint = 'ice.cn-xxx.aliyuncs.com'
    client = ICE20201109Client(config)
    
    submit_smarttag_job_request_input = ice20201109_models.SubmitSmarttagJobRequestInput(
        type='URL',
        media='https://xxx.jpeg'
    )
    submit_smarttag_job_request = ice20201109_models.SubmitSmarttagJobRequest(
        title='face_test-001',
        input=submit_smarttag_job_request_input,
        template_id='xxx'
    )
    runtime = util_models.RuntimeOptions()
    response = client.submit_smarttag_job_with_options(submit_smarttag_job_request, runtime)
    print(response)
  3. ジョブ結果のクエリ

    QuerySmarttagJob API 操作を呼び出して、インテリジェントコンテンツ理解ジョブをクエリできます。

    サンプルコード:

    # -*- coding: utf-8 -*-
    from alibabacloud_ice20201109.client import Client as ICE20201109Client
    from alibabacloud_credentials.client import Client as CredentialClient
    from alibabacloud_tea_openapi import models as open_api_models
    from alibabacloud_ice20201109 import models as ice20201109_models
    from alibabacloud_tea_util import models as util_models
    
    # 本番環境では、RAM ロールなどのより安全な認証方式を使用することを推奨します。 認証情報の設定方法の詳細については、https://www.alibabacloud.com/help/document_detail/378659.html をご参照ください。
    credential = CredentialClient()
    config = open_api_models.Config(
        credential=credential
    )
    # エンドポイントについては、https://api.aliyun.com/product/ICE をご参照ください。
    config.endpoint = 'ice.cn-xxx.aliyuncs.com'
    client = ICE20201109Client(config)
    
    query_smarttag_job_request = ice20201109_models.QuerySmarttagJobRequest(
        job_id='xxx'
    )
    runtime = util_models.RuntimeOptions()
    response = client.query_smarttag_job_with_options(query_smarttag_job_request, runtime)
    print(response)

高度な使用方法

  1. カスタムライブラリの作成

    CreateRecognitionLib API 操作を呼び出して、カスタム認識ライブラリを作成できます。

    サンプルコード:

    # -*- coding: utf-8 -*-
    from alibabacloud_ice20201109.client import Client as ICE20201109Client
    from alibabacloud_credentials.client import Client as CredentialClient
    from alibabacloud_tea_openapi import models as open_api_models
    from alibabacloud_ice20201109 import models as ice20201109_models
    from alibabacloud_tea_util import models as util_models
    
    # 本番環境では、RAM ロールなどのより安全な認証方式を使用することを推奨します。 認証情報の設定方法の詳細については、https://www.alibabacloud.com/help/document_detail/378659.html をご参照ください。
    credential = CredentialClient()
    config = open_api_models.Config(
        credential=credential
    )
    # エンドポイントについては、https://api.aliyun.com/product/ICE をご参照ください。
    config.endpoint = 'ice.cn-xxx.aliyuncs.com'
    client = ICE20201109Client(config)
    
    create_recognition_lib_request = ice20201109_models.CreateRecognitionLibRequest(
        algorithm='face',
        lib_name='face_lib_001'
    )
    runtime = util_models.RuntimeOptions()
    response = client.create_recognition_lib_with_options(create_recognition_lib_request, runtime)
    print(response)
  2. カスタムエンティティの作成

    CreateRecognitionEntity API 操作を呼び出して、指定されたカスタム認識ライブラリに新しいエンティティを作成できます。

    サンプルコード:

    # -*- coding: utf-8 -*-
    from alibabacloud_ice20201109.client import Client as ICE20201109Client
    from alibabacloud_credentials.client import Client as CredentialClient
    from alibabacloud_tea_openapi import models as open_api_models
    from alibabacloud_ice20201109 import models as ice20201109_models
    from alibabacloud_tea_util import models as util_models
    
    # 本番環境では、RAM ロールなどのより安全な認証方式を使用することを推奨します。 認証情報の設定方法の詳細については、https://www.alibabacloud.com/help/document_detail/378659.html をご参照ください。
    credential = CredentialClient()
    config = open_api_models.Config(
        credential=credential
    )
    # エンドポイントについては、https://api.aliyun.com/product/ICE をご参照ください。
    config.endpoint = 'ice.cn-xxx.aliyuncs.com'
    client = ICE20201109Client(config)
    
    create_recognition_entity_request = ice20201109_models.CreateRecognitionEntityRequest(
        algorithm='face',
        lib_id='xxx',
        entity_name='田中太郎'
    )
    runtime = util_models.RuntimeOptions()
    response = client.create_recognition_entity_with_options(create_recognition_entity_request, runtime)
    print(response)
  3. カスタムオブジェクトの作成

    CreateRecognitionSample API 操作を呼び出して、指定されたカスタムエンティティのサンプル画像またはテキストタグを追加できます。

    サンプルコード:

    # -*- coding: utf-8 -*-
    
    from alibabacloud_ice20201109.client import Client as ICE20201109Client
    from alibabacloud_credentials.client import Client as CredentialClient
    from alibabacloud_tea_openapi import models as open_api_models
    from alibabacloud_ice20201109 import models as ice20201109_models
    from alibabacloud_tea_util import models as util_models
    
    # 本番環境では、RAM ロールなどのより安全な認証方式を使用することを推奨します。 認証情報の設定方法の詳細については、https://www.alibabacloud.com/help/document_detail/378659.html をご参照ください。
    credential = CredentialClient()
    config = open_api_models.Config(
        credential=credential
    )
    # エンドポイントについては、https://api.aliyun.com/product/ICE をご参照ください。
    config.endpoint = 'ice.cn-xxx.aliyuncs.com'
    client = ICE20201109Client(config)
    
    create_recognition_sample_request = ice20201109_models.CreateRecognitionSampleRequest(
        algorithm='face',
        lib_id='xxx',
        entity_id='xxx',
        image_url='https://xxx.jpg'
    )
    runtime = util_models.RuntimeOptions()
    response = client.create_recognition_sample_with_options(create_recognition_sample_request, runtime)
    print(response)
  4. コンテンツ理解アルゴリズムテンプレートの作成

    このステップは、基本的な使用方法のセクションと同じです。 顔、ランドマーク、オブジェクト、ロゴ、カスタムタグなどの項目に対して、分析タイプオペレーターと対応するカスタムライブラリ ID を指定することもできます。

  5. インテリジェントコンテンツ理解ジョブの送信

    このステップは、基本的な使用方法のセクションと同じです。

  6. ジョブ結果のクエリ

    このステップは、基本的な使用方法のセクションと同じです。