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 | はい | クエリの内容。 | | |
docs | List[ContentObject] | はい | 複数のドキュメントを入力できます。各リクエストは最大 100 ドキュメントをサポートします。 | |
options | いいえ | 入力にイメージが含まれる場合は、オプションを使用してイメージのサイズ変更設定を構成します。 |
ContentObject
パラメーター | タイプ | 必須 | 説明 | 例 |
text | String | いいえ | テキストの内容。 | |
image | String | いいえ | イメージの内容。URL または Base64 エンコード文字列を使用します。
| または |
OptionObject
パラメーター | タイプ | 必須 | 説明 | 例 |
resize_method | String | いいえ | イメージのサイズ変更に使用されるメソッド:
| fixed_size |
resize_options | Object | いいえ | イメージのサイズ変更用のパラメーター。このパラメーターは、resize_method が fixed_size または proportional_scaling に設定されている場合にのみ必須です。
|
レスポンスパラメーター
パラメーター | タイプ | 説明 | 例 |
request_id | String | システムが API 呼び出しに対して生成した一意の ID。 | A5B25952-4406-45BF-99EC-E8020246**** |
latency | Float/Int | リクエストのレイテンシ (ミリ秒、ms)。 | 10 |
usage.doc_count | Int | リクエスト内のドキュメント数。 | 2 |
result.scores | List<score> | スコアの降順でソートされたドキュメント。 | |
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
}
]
}
}
ステータスコード
詳細については、「ステータスコード」をご参照ください。