Rerank API: 検索結果を relevance_score で並べ替える

By Tokuse
APIRerank検索関連度
他の言語でも読む：English한국어

Rerank はクエリと文書の関連度を再評価するエンドポイントです。ベクトル検索で集めた候補を上位に絞り込むときに使います。レスポンスには文書ごとの relevance_score が含まれます。

エンドポイント

POST https://tokuse.com/v1/rerank

認証

リクエストヘッダーに Authorization: Bearer sk-your-tokuse-key を付けます。API キーはサーバー側で管理してください。

対応モデル

rerank モデルを使用します。上流でモデルの開通が必要です。利用できるモデル ID は Tokuse のモデル一覧で確認してください。

リクエスト例

curl https://tokuse.com/v1/rerank \
  -H "Authorization: Bearer sk-your-tokuse-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "rerank-model",
    "query": "API ゲートウェイの料金",
    "documents": [
      "Tokuse の料金ページではモデルごとの単価を確認できます。",
      "動画生成は非同期タスクとして実行されます。",
      "API キーはサーバー側で管理してください。"
    ]
  }'

レスポンス例

{
  "model": "rerank-model",
  "results": [
    {"index": 0, "relevance_score": 0.9821},
    {"index": 2, "relevance_score": 0.4137},
    {"index": 1, "relevance_score": 0.1024}
  ]
}

注意事項と制限

  • 上流で rerank モデルを開通させてください。未開通の場合、リクエストに失敗します。
  • relevance_score はクエリと文書の関連度です。値が高いほど関連の強い文書です。
  • index はリクエストの documents 配列の位置に対応します。結果はスコア順に並べ替えて使ってください。
  • 文書数と長さの制限は利用するモデルに依存します。Tokuse のモデル一覧で確認してください。

料金

料金はモデルと上流の単価で決まります。具体的な金額は Tokuse の料金ページと上流コンソールで確認してください。