メインコンテンツへスキップ
POST
ドキュメントを再ランキング
検索、取得、生成の処理に渡す前に、候補ドキュメントを並べ替えるためのエンドポイントです。 デプロイ前にGET /v1/modelsでモデルを確認してください。既定のレスポンスには公開Gatewayルートがあるモデルのみが含まれます。

承認

Authorization
string
header
必須

Bearer トークンによる認証

ボディ

application/json
model
string
必須
query
string
必須
documents
必須
Minimum array length: 1
models
string[]

model の後に試行される、任意の順序付きフォールバックモデルです。model は必須で、常にプライマリモデルです。試行が 429、500、502、503、504 で失敗すると次のエントリーが試行され、その他のエラーはそのまま返されます。最大 25 個のモデル ID またはプリセットを指定でき、重複や model と同じエントリーは無視されます。各試行は個別のリクエストとして検証、記録、課金され、レスポンスの model フィールドとルーティングトレースには、リクエストを処理したモデルが表示されます。ストリーミングリクエストは最初のバイトの送信前にのみフォールバックし、動画と音楽のジョブは送信時にのみフォールバックします。Batch、realtime、council のリクエストは models を拒否します。動的ルートで設定されたフォールバックが優先され、phaseo/auto は models と併用できません。

Required array length: 1 - 25 elements
Minimum string length: 1
例:
top_n
integer
必須範囲: x >= 1
top_k
integer

top_n のエイリアスです。

必須範囲: x >= 1
return_documents
boolean
max_chunks_per_doc
integer
必須範囲: x >= 1
rank_fields
string[]
user
string
metadata
object
provider_options
object
debug
object

ゲートウェイのデバッグ設定です。これらのフラグがプロバイダーに転送されることはありません。

provider
object

ゲートウェイでの選択に使用するプロバイダーのルーティング設定。

レスポンス

200 - application/json

再ランキングの応答

object
string
id
string
nativeResponseId
string | null
model
string
results
object[]
usage
object
最終更新日 2026年11月16日