API 參考

重排序

目前沒有可用模型

目前模型目錄裡沒有模型支援這個介面，本頁僅供參考。

POST/v1/rerank

針對一個查詢為候選文件清單評分。結果依相關性從高到低回傳，並保留每個文件的原始索引。

#請求參數

modelstring必填
即時模型目錄中準確的重排序模型識別碼。
querystring必填
用於為候選內容評分的搜尋查詢或問題。
documentsstring[]必填
待重排序的候選文字；應用程式中應保留其原始順序。
top_ninteger選填
最多回傳的重排序結果數量。
return_documentsboolean選填
模型支援時，在結果中包含文件文字。

#相關錯誤碼

400 invalid_request_errorquery 或 documents 缺失、為空，或目前模型不支援。
401Bearer 權杖無效或缺失。這條路徑不帶 error.code，請依狀態碼判斷。
402 insufficient_user_quota錢包餘額不足以覆蓋預扣估算。
429金鑰級限流。回應主體為空，按 Retry-After 等待。若 429 帶有 insufficient_user_quota，那是每日消費上限，不是限流。
503 model_not_found模型名稱不存在，或目前沒有健康的通道可以提供服務。

完整錯誤碼表 →

#請求範例

curl https://www.aisplice.store/v1/rerank \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_RERANK_MODEL",
    "query": "What is the capital of France?",
    "documents": [
      "Paris is the capital of France.",
      "Berlin is in Germany."
    ],
    "top_n": 2
  }'

#回應

response.json

{
  "results": [
    { "index": 0, "relevance_score": 0.9821 },
    { "index": 1, "relevance_score": 0.1034 }
  ]
}

還是沒解決？

把請求 ID 或錯誤訊息傳給我們，我們來查。