Skip to main content
POST
Rerank

Introduction

Rerank documents by relevance to a query, commonly used in RAG to optimize retrieval results.

Authentication

string
required
Bearer Token, e.g. Bearer sk-xxxxxxxxxx

Request Parameters

string
required
Model name, e.g. rerank-v1
string
required
Query text
array
required
List of documents to rank
integer
Return top N results (default: all)
boolean
default:"false"
Return document content

cURL Example

Python Example

Response Fields

Notes

  • Common in RAG: first vector search for candidates, then rerank to optimize
  • Higher relevance_score means more relevant to query
  • Requires requests library: pip install requests