Rerank

Rerank documents

Authorization

bearerAuth

AuthorizationBearer <token>

API key in format: eur_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

model*string

Model identifier (e.g., "qwen/qwen3-reranker-4b")

Length1 <= length

query*string

The search query to rank the documents against

Length1 <= length

documents*array<|>

Documents to rank: plain strings or {"text": "..."} objects (text-only for now). At least one is required; there is no upper count limit. Search-unit-billed endpoints charge one unit per started block of 100 documents.

Items1 <= items

top_n?integer

Return only the N most relevant results. Default: all documents, ranked. Ranking always covers every document, so top_n does not reduce billing.

Range1 <= value <= 9007199254740991

provider?

Provider routing preferences

trace?

Trace context for Broadcast observability

session_id?string

Session identifier for grouping related requests

Lengthlength <= 128

[key: string]?unknown

Response Body

`application/json`

curl -X POST "https://api.eurouter.ai/api/v1/rerank" \  -H "Content-Type: application/json" \  -d '{    "model": "string",    "query": "string",    "documents": [      "string"    ],    "property1": null,    "property2": null  }'

{
  "id": "string",
  "model": "string",
  "results": [
    {
      "index": -9007199254740991,
      "relevance_score": 0,
      "document": {
        "text": "string"
      }
    }
  ],
  "usage": {
    "prompt_tokens": -9007199254740991,
    "total_tokens": -9007199254740991,
    "search_units": -9007199254740991,
    "cost": 0,
    "cost_currency": "USD",
    "cost_eur": 0,
    "is_byok": true,
    "cost_details": {
      "upstream_inference_cost": 0,
      "upstream_inference_prompt_cost": 0,
      "upstream_inference_completions_cost": 0
    }
  },
  "provider": "string"
}