オブジェクト検出 - OpenSearch - Alibaba Cloud ドキュメントセンター

このサービスは、画像内の 1 つまたは複数のオブジェクトを自動的に検出して識別します。インテリジェント監視、自動運転、画像検索などの典型的なコンピュータビジョンアプリケーションに最適です。

サービス名	サービス ID	説明	API QPS 制限
object detection service	ops-object-detect-001	Alibaba Cloud OpenSearch-AI チームが開発したマルチオブジェクト検出モデルは、画像内の複数の独立したオブジェクトを検出し、それぞれについてバウンディングボックスと信頼度を返します。このモデルを使用して、複雑なシーンからオブジェクトを抽出し、ダウンストリームタスクへの入力として利用できます。また、埋め込みおよび再ランキングモデルと組み合わせることで、画像のバックグラウンドや他のオブジェクトによる干渉を除去するのに役立ちます。	20 説明

face detection service	ops-object-detect-face-001	画像内の 1 つまたは複数の顔を自動的に検出して位置を特定します。インテリジェント監視や画像検索などのアプリケーションに最適です。

前提条件

リクエストの詳細

一般的な注意事項

リクエストボディは 8 MB を超えてはなりません。

HTTP メソッド

POST

URL

{host}/v3/openapi/workspaces/{workspace_name}/image-object-detection/{service_id}

パラメーター：

host：サービスエンドポイント。パブリックネットワーク経由または VPC 内から API サービスを呼び出すことができます。詳細については、「サービスエンドポイントの取得」をご参照ください。パブリック API ドメインはパブリックネットワークアクセスを提供し、内部 API ドメインは同一リージョン内（VPC 内を含む）からのアクセスを提供します。どちらのエンドポイントも HTTPS プロトコルをサポートしています。
workspace_name：ご利用のワークスペース名（例：default）。
service_id：組み込みサービスの ID（例：ops-object-detect-001）。

リクエストパラメーター

ヘッダーパラメーター

パラメーター	タイプ	必須	説明	例
Content-Type	String	はい	リクエストのコンテンツタイプ。値は `application/json` である必要があります。	application/json
Authorization	String	はい	認証用の API キー。値には `Bearer` をプレフィックスとして付加する必要があります。	Bearer OS-d1**2a

ボディパラメーター

パラメーター

タイプ

必須

説明

例

service_id

String

はい

サービス ID。値は ops- で始まる必要があります。

ops-object-detect-001

image

Object

はい

処理対象の画像。以下のいずれかのパラメーターを使用して画像を指定する必要があります。

url：画像のパブリックにアクセス可能な URL。
content： base64 文字列としてエンコードされた画像ファイルの内容。

{
 "url":"http://example.com/image.jpg"
}

応答パラメーター

パラメーター	タイプ	説明	例
request_id	String	リクエストに対してシステムが生成する一意の識別子。	A5B25952-4406-45BF-99EC-E8020246****
latency	Float/Integer	リクエストの遅延時間（ミリ秒単位）。	10
usage.image	Integer	処理された画像の枚数。	1
result.objects	List<ImageObject>	検出されたオブジェクトのリスト。	`[ { "confidence": 0.8, "location": { "X" : 228, "Y" : 240, "height" : 430, "width" : 678 } } ]`

ImageObject

パラメーター	タイプ	説明	例
confidence	Float	検出の信頼度（0.0～1.0 の範囲）。値が大きいほど信頼度が高いことを示します。	0.4017
location	Object	バウンディングボックスの座標を含むオブジェクト。
location.width	Integer	バウンディングボックスの幅（ピクセル単位）。	176
location.height	Integer	バウンディングボックスの高さ（ピクセル単位）。	188
location.Y	Integer	バウンディングボックスの左上隅の y 座標。	560
location.X	Integer	バウンディングボックスの左上隅の x 座標。	37

cURL によるリクエスト例

curl --location 'http://****-hangzhou.opensearch.aliyuncs.com/v3/openapi/workspaces/default/image-object-detection/ops-object-detect-001/' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "image":
    {
      "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250408/syuvxh/%E7%89%A9%E4%BD%93%E5%AE%9A%E4%BD%8D.png"
    }
}'

応答例

成功時の応答

{
  "request_id": "138611ad4a03f620a1cdb2904768d286",
  "latency": 216,
  "usage": {
    "image": 1
  },
  "result": {
    "objects": [
      {
        "confidence": 0.4017,
        "location": {
          "width": 176,
          "height": 188,
          "X": 37,
          "Y": 560
        }
      },
      {
        "confidence": 0.3805,
        "location": {
          "width": 191,
          "height": 200,
          "X": 133,
          "Y": 752
        }
      },
      {
        "confidence": 0.3290,
        "location": {
          "width": 175,
          "height": 183,
          "X": 359,
          "Y": 663
        }
      },
      {
        "confidence": 0.2955,
        "location": {
          "width": 984,
          "height": 897,
          "X": 16,
          "Y": 8
        }
      },
      {
        "confidence": 0.2613,
        "location": {
          "width": 172,
          "height": 174,
          "X": 516,
          "Y": 559
        }
      },
      {
        "confidence": 0.2573,
        "location": {
          "width": 360,
          "height": 228,
          "X": 665,
          "Y": 704
        }
      },
      {
        "confidence": 0.2419,
        "location": {
          "width": 139,
          "height": 170,
          "X": 248,
          "Y": 388
        }
      },
      {
        "confidence": 0.1644,
        "location": {
          "width": 173,
          "height": 205,
          "X": 815,
          "Y": 507
        }
      },
      {
        "confidence": 0.1134,
        "location": {
          "width": 140,
          "height": 122,
          "X": 440,
          "Y": 446
        }
      }
    ]
  }
}

ステータスコード

詳細については、AI Search Open Platform の「ステータスコード」をご参照ください。