Skip to content

Rerank documents

POST
/v1/rerank
curl --request POST \
--url https://api.mirapi.ai/v1/rerank \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "model": "rerank-english-v2.0", "query": "example", "documents": [ {} ], "top_n": 1, "return_documents": false }'

Reranks a list of documents by relevance to the query

Media typeapplication/json
object
model
required
string
Example
rerank-english-v2.0
query
required

Query text

string
documents
required

Documents to rerank

Array
One of:
string
top_n

Return the top N results

integer
return_documents
boolean

Documents reranked

Media typeapplication/json
object
id
string
results
Array<object>
object
index
integer
relevance_score
number
document
object
meta
object
Examplegenerated
{
"id": "example",
"results": [
{
"index": 1,
"relevance_score": 1,
"document": {}
}
],
"meta": {}
}