Endpoint
Example
Response
Compare scores only within one model. A cutoff tuned on one reranker (for example, keep documents scoring above 0.5) does not carry over to another.
queries and documents must be the same length, except that a single query is broadcast across many documents (the common case shown above). The Qwen3 rerankers take an optional instruction field that steers the reranking task; it defaults to "Given a web search query, retrieve relevant passages that answer the query". Other models ignore it.
Usage in a RAG pipeline
A typical pattern:- Retrieve — run a vector similarity search to fetch the top-N candidate chunks (e.g. top 50)
- Rerank — pass the query + candidates to a reranker to get relevance scores
- Select — keep only the top-K highest-scoring chunks (e.g. top 5) for the LLM context