Skip to main content
POST
Rerank documents

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

ai_project_id
string | null

current project ID

Body

application/json
model
string
required

ID of the model to use.

Example:

"Qwen/Qwen3-Reranker-8B"

query
string
required

Query to rerank, encoded as a string.

Example:

"What is the capital of France?"

documents
string[]
required

Documents to rerank, encoded as a list of strings.

Example:
user
string | null

A unique identifier representing your end-user.

service_tier
enum<string>
default:auto

The service tier to use for the request.

Available options:
auto,
default,
over-limit,
flex,
no-limit
Examples:

"auto"

"flex"

Response

OK

id
string
required

A unique identifier for the reranking response.

model
string
required

The model used for the reranking.

usage
RerankUsage · object
required

Token usage stats.

results
RerankResult · object[]
required

List of RerankResult objects