排序服務 - OpenSearch

AI搜尋開放平台支援通過API的方式調用文檔相關性打分服務，您可以將服務整合到您的業務處理鏈路中，來提升檢索效果。

服務名稱	服務ID	服務描述	API調用QPS限制（含主帳號與RAM子帳號）
BGE重排模型	ops-bge-reranker-larger	提供基於BGE模型的文檔打分服務，可根據query與文檔內容的相關性，按分數由高到低對doc進行排序，並輸出對應的打分結果。支援中英雙語，最大輸入token長度512（Query+doc長度）。	20 說明如需擴充QPS，請通過工單聯絡支援人員協助。
BGE重排模型	ops-bge-reranker-larger
OpenSearch文本排序-001	ops-text-reranker-001	OpenSearch自研重排模型，融合多行業資料集訓練，提供高水準的重排服務，可根據Query及doc的語義相關性從高到低對doc進行排序。支援中英雙語，最大輸入token長度512（Query+doc長度）。
Qwen3排序服務-0.6B	ops-qwen3-reranker-0.6b	Qwen3系列文檔重排服務，支援100+語言，最大輸入token長度32k（Query+doc長度），參數量0.6B。

前提條件

擷取身份鑒權資訊
通過API調用AI搜尋開放平台服務時，需要對調用者身份進行鑒權，如何擷取鑒權資訊請參見擷取API-KEY。
擷取服務調用地址
支援通過公網和VPC兩種方式調用服務，詳情請參見擷取服務接入地址。

請求說明

公用說明

請求body最大不能超過8MB。

請求方式

POST

URL

{host}/v3/openapi/workspaces/{workspace_name}/ranker/{service_id}

參數說明：

host：調用服務的地址，支援通過公網和VPC兩種方式調用API服務，可參見擷取服務接入地址。
workspace_name：工作空間名稱，例如default。
service_id：系統內建服務id，例如ops-bge-reranker-larger。

請求參數

Header參數

API-KEY認證

參數	類型	必填	描述	樣本值
Content-Type	String	是	請求類型：application/json	application/json
Authorization	String	是	API-Key	Bearer OS-d1**2a

Body參數

參數

類型

必填

描述

樣本值

query

String

是

查詢內容。

上海有什麼好玩的

docs

List<String>

是

文檔內容（列表）。

["上海有許多好玩的地方",

"北京有許多好玩的地方"]

返回參數

參數	類型	描述	樣本值
request_id	String	系統對一次API調用賦予的唯一標識。	A5B25952-4406-45BF-99EC-E8020246****
latency	Float/Int	請求耗時，單位ms。	10
usage.doc_count	Int	本次請求輸入的文檔數量。	2
result.scores	List<score>	按分數由高到低對doc進行排序的結果。	[ { "index":1, "score":0.99 }, { "index":2, "score":0.05 } ]
result.scores[].index	Int	本doc在輸入候選doc數組中的位置索引值。	1
result.scores[].score	Float	打分結果，值越大表示相關性越高。	0.99

Curl請求樣本

curl -XPOST -H"Content-Type: application/json" 
"http://****-hangzhou.opensearch.aliyuncs.com/v3/openapi/workspaces/default/ranker/ops-bge-reranker-larger" 
-H "Authorization: Bearer 您的API-KEY" 
-d "{
    \"query\":\"opensearch產品文檔\",
    \"docs\":[
        \"什麼是opensearch\",
        \"什麼是智能問答版\",
        \"智能問答版有啥優勢\"
      ]
}"

響應樣本

正常響應樣本

{
  "request_id":"24B004E0-ADEF-****-879B-F28359BFAD1D",
  "latency":19,
  "usage":{
      "doc_count":3
  },
  "result":{
      "scores":[
        {
          "index":0,"score":0.45026873385713345
        },
        {
          "index":1,"score":1.1412238544346029E-4
        },
        {
          "index":2,"score":8.029784284533197E-5
        }
      ]
    }
  }

異常響應樣本

在訪問請求出錯的情況下，輸出的結果中會通過code和message指明出錯原因。

{
    "request_id": "45C8C9E5-6BCB-****-80D3-E298F788512B",
    "latency": 0,
    "code": "InvalidParameter",
    "message": "JSON parse error: Unexpected character ..."
}

狀態代碼說明

請參見AI搜尋開放平台狀態代碼說明。