POST
/v1/rerankRerank documents by relevance to a query
Credit metering
Authentication
Send your virtual key as Authorization: Bearer sk-nemo-…. One key works across every model and modality.
Request bodyapplication/json
| Field | Type | Required |
|---|---|---|
| model | string | required |
| query | string | required |
| documents | array | required |
| top_n | integer | optional |
Response200
{
"id": "rerank-abc123",
"results": [
{
"index": 1,
"relevance_score": 0.98
},
{
"index": 0,
"relevance_score": 0.41
}
],
"meta": {
"billed_units": {
"search_units": 1
}
}
}Errors
| Status | Meaning |
|---|---|
| 400 | 400 — Guardrail blocked the request |
| 402 | 402 — Not enough credits |
| 429 | 429 — one of: rate_limit_exceeded (RPM limit exceeded); tpm_limit_exceeded (TPM limit exceeded) |
| 503 | 503 — Credit system unavailable |