Skip to main content
POST
Rerank documents
Rerank a list of documents against a query using jina-reranker-v3. Provide a non-empty query and a non-empty documents array; results come back ordered by relevance_score. Use the optional top_n to return only the most relevant documents. This pairs naturally with embeddings-based retrieval: embed and shortlist candidates, then rerank for final ordering. Served at the AIsa API path /v1/rerank — OpenAI-compatible. Billing is token-based; the usage.total_tokens field reports the tokens billed for each request.

Request contract

  • Method and path: POST /rerank
  • Request URL template: https://api.aisa.one/v1/rerank
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Authorizations

Authorization
string
header
required

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

Body

application/json
documents
string[]
required

Non-empty array of document strings to rerank.

Minimum array length: 1
Example:
model
string
required

Rerank model name.

Example:

"jina-reranker-v3"

query
string
required

Non-empty query string to rank documents against.

Example:

"What is the capital of France?"

top_n
integer

Optional. Return only the top N most relevant documents.

Example:

2

Response

200 - application/json

Reranked results ordered by relevance.

model
string
Example:

"jina-reranker-v3"

results
object[]
usage
object