すべてのプロダクト
Search

このプロダクト

    Intelligent Media Management:DetectImageCropping

    ドキュメントセンター

    Intelligent Media Management:DetectImageCropping

    最終更新日:Jun 23, 2026

    AI モデル機能を使用して、指定された縦横比でイメージ内の視覚的に最適なクロッピングリージョンを検出します。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    imm:DetectImageCropping

    none

    *Project

    acs:imm:{#regionId}:{#accountId}:project/{#ProjectName}

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    ProjectName

    string

    必須

    プロジェクト名。

    immtest
    SourceURI

    string

    任意

    イメージの OSS URI。

    OSS URI は oss://${Bucket}/${Object} のフォーマットに従います。${Bucket} は現在のプロジェクトと同じリージョンにある OSS バケットの名前、${Object} はファイル名拡張子を含むファイルの完全なパスです。

    oss://imm-test/testcases/facetest.jpg
    AspectRatios

    string

    任意

    クロッピング縦横比のリスト。最大 5 つの比率を指定できます。各比率は以下の要件を満たす必要があります:

    • 比率は (0, 20) の有効値の整数で構成される必要があります。

    • 比率の値は [0.5, 2] の有効値内である必要があります。

    • このパラメーターを指定しない場合、デフォルト値 ["auto"] が使用されます。

    説明

    以下の場合はエラーが発生します:
    - 5 つを超える比率が指定された場合。
    - 空のリストが渡された場合。
    - 比率に 4.1:3 などの非整数値が含まれている場合。
    - 比率の値が 0.5 未満または 2 を超える場合。

    ["1:1"]
    CredentialConfig CredentialConfig

    任意

    特に必要でない限り、このパラメーターは空のままにしてください。

    China 権限付与構成。このパラメーターはオプションです。詳細については、チェーン権限付与を使用して他のエンティティのリソースにアクセスするを参照してください。

    InclusionHints

    array

    任意

    クロッピング結果に含めたいオブジェクトのセマンティックテキスト説明のリスト。各要素は「signboard」や「dish」などのフリーフォームのテキストです。

    説明

    InclusionHints パラメーターの使用制限:
    - 配列に最大 1 つのヒントワードを渡して、「signboard」などクロッピング結果に含めるオブジェクトのタイプを指定できます。
    - アルゴリズムはイメージ内のヒントワードに一致するすべてのオブジェクトを検出し、一致するオブジェクトをできるだけ多く含むクロッピングリージョンを生成します。
    - 各クロッピングリージョンには最大 10 個の一致オブジェクトが含まれます。イメージ内で 10 個を超えるオブジェクトが一致する場合、クロッピングリージョンにはそのうち最大 10 個が含まれます。
    - MatchedInclusionHints 応答フィールドを使用して、ヒントワードが正常に一致したかどうかを判断できます。
    - このパラメーターは中国本土のリージョンでのみサポートされています。

    ["sign"]

    string

    任意

    クロッピング結果に含めたいオブジェクトのセマンティックテキスト説明。

    sign

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    イメージクロッピング結果。

    Croppings

    array

    イメージクロッピング情報の配列。

    CroppingSuggestion

    イメージの詳細なクロッピング情報。

    RequestId

    string

    リクエスト ID。

    91AC8C98-0F36-49D2-8290-742E24D*****
    MatchedInclusionHints

    array

    クロッピングリージョンに含まれるオブジェクトのリスト。入力パラメーター InclusionHints に対応します。オブジェクトが含まれていない場合、このフィールドは空です。

    string

    クロッピングリージョンに含まれるオブジェクト。

    sign

    例

    成功レスポンス

    JSONJSON

    {
  "Croppings": [
    {
      "AspectRatio": "2:3",
      "Confidence": 0.742,
      "Boundary": {
        "Width": 200,
        "Height": 300,
        "Left": 10,
        "Top": 30,
        "Polygon": [
          {
            "X": 10,
            "Y": 10
          }
        ]
      }
    }
  ],
  "RequestId": "91AC8C98-0F36-49D2-8290-742E24D*****",
  "MatchedInclusionHints": [
    "sign"
  ]
}

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。