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

OpenSearch:マルチモーダルリランキング

最終更新日:Jan 17, 2026

OpenSearch AI チームが開発したマルチモーダルリランキングモデルは、テキストまたはイメージ形式のクエリとドキュメントを受け付けます。0 から 1 の範囲で関連性スコアを返します。スコアが高いほど、関連性が高いことを示します。

サービス

サービス ID

説明

API QPS 制限 (Alibaba Cloud アカウントと RAM ユーザーで共有)

マルチモーダルリランキング

ops-mm-reranker-001

このサービスは、イメージの関連性ソートを提供します。検索拡張生成 (RAG) およびマルチモーダル検索シナリオでは、このサービスはより関連性の高いコンテンツを順番に見つけて返します。このサービスを使用すると、取得と大規模モデル生成の精度が向上します。

20

説明

より高い QPS を申請するには、チケットを送信してください。

前提条件

  • 認証情報を取得済みであること。

    API を使用して AI Search Open Platform サービスを呼び出す際には、呼び出し元の ID を認証する必要があります。

  • サービスアクセスアドレスを取得済みであること。

    サービスは、インターネットまたは Virtual Private Cloud (VPC) 経由で呼び出すことができます。詳細については、「サービス登録アドレスの取得」をご参照ください。

リクエストの説明

概要

  • リクエストボディは 8 MB を超えることはできません。

リクエストメソッド

POST

URL

{host}/v3/openapi/workspaces/{workspace_name}/multi-modal-reranker/{service_id} 

パラメーター:

  • host:サービスエンドポイント。パブリックネットワークまたは VPC 経由でサービスを呼び出すことができます。詳細については、「サービスエンドポイントの取得」をご参照ください。

  • workspace_name:ワークスペースの名前。例: default。

  • service_id:組み込みのサービス ID。例: ops-mm-reranker-001。

リクエストパラメーター

ヘッダーパラメーター

API キー認証

パラメーター

タイプ

必須

説明

Content-Type

String

はい

リクエストタイプ: application/json

application/json

Authorization

String

はい

API キー

Bearer OS-d1**2a

ボディパラメーター

パラメーター

タイプ

必須

説明

service_id

String

はい

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

ops-mm-reranker-001

query

ContentObject

はい

クエリの内容。text または image のいずれかを指定します。両方を指定することも、両方を空にすることもできません。

{
 "text":"Science and technology are the primary productive forces"
}

docs

List[ContentObject]

はい

複数のドキュメントを入力できます。各リクエストは最大 100 ドキュメントをサポートします。

[
  {
    "text":"Science and technology are the primary productive forces"
  },
  {
    "image":"http://***/a.jpg"
  }
]

options

OptionObject

いいえ

入力にイメージが含まれる場合は、オプションを使用してイメージのサイズ変更設定を構成します。

ContentObject

パラメーター

タイプ

必須

説明

text

String

いいえ

テキストの内容。

{
  "text":"Text input"
}

image

String

いいえ

イメージの内容。URL または Base64 エンコード文字列を使用します。

  • URL を使用する場合、アクセス可能である必要があります。

  • イメージに Base64 データを使用するには、エンコードされた Base64 データを image パラメーターに渡します。

{
  "image":"http://xxxxx/a.jpg"
}

または

{
  "image":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAoHCB..."
}

OptionObject

パラメーター

タイプ

必須

説明

resize_method

String

いいえ

イメージのサイズ変更に使用されるメソッド:

  • default:モデルに組み込まれているデフォルトのスケーリングメソッド。

  • none:スケーリングは実行されません。

  • fixed_size:イメージを指定されたサイズに変更します。サイズは resize_options を使用して設定します。

  • proportional_scaling:縦横比を維持しながら、イメージを指定されたピクセル範囲にサイズ変更します。

fixed_size

resize_options

Object

いいえ

イメージのサイズ変更用のパラメーター。このパラメーターは、resize_method が fixed_size または proportional_scaling に設定されている場合にのみ必須です。

  • resize_method が fixed_size の場合、resize_options を次のように設定します:

    {
        "width": 224,   // 単位:ピクセル。サイズ変更後のイメージの幅。
        "height": 224   // 単位:ピクセル。サイズ変更後のイメージの高さ。
    }
  • resize_method が proportional_scaling の場合、resize_options を次のように設定します:

    {
        "min_pixels": 409600,   // 単位:ピクセル。サイズ変更後のイメージの最小ピクセル数。
        "max_pixels": 1638400   // 単位:ピクセル。サイズ変更後のイメージの最大ピクセル数。
    }

レスポンスパラメーター

パラメーター

タイプ

説明

request_id

String

システムが API 呼び出しに対して生成した一意の ID。

A5B25952-4406-45BF-99EC-E8020246****

latency

Float/Int

リクエストのレイテンシ (ミリ秒、ms)。

10

usage.doc_count

Int

リクエスト内のドキュメント数。

2

result.scores

List<score>

スコアの降順でソートされたドキュメント。

{
  "request_id": "1b87e3c462079a32999a7c8bc173ca7a",
  "latency": 1765,
  "usage": {
    "image_token": 1225,
    "text_token": 16
  },
  "result": {
    "scores": [
      {
        "index": 0,
        "score": 0.9183856248855591
      }
    ]
  }
}

result.scores[].index

Int

現在の位置にあるドキュメントのインデックス。

1

result.scores[].score

Float

関連性スコア。値が高いほど、関連性が高いことを示します。

0.99

cURL リクエストの例

curl --location 'http://****-hangzhou.opensearch.aliyuncs.com/v3/openapi/workspaces/default/multi-modal-reranker/ops-mm-reranker-001/' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
  "query": {
    "text": "Is there a cake in the picture?"
  },
  "docs": [
    {
      "image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/20250408/syuvxh/%E7%89%A9%E4%BD%93%E5%AE%9A%E4%BD%8D.png"
    }
  ]
}'

レスポンスの例

成功レスポンスの例

{
  "request_id": "1b87e3c462079a32999a7c8bc173ca7a",
  "latency": 1765,
  "usage": {
    "image_token": 1225,
    "text_token": 16
  },
  "result": {
    "scores": [
      {
        "index": 0,
        "score": 0.9183856248855591
      }
    ]
  }
}

ステータスコード

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