- Input / 1M tokens
- $0
- Output / 1M tokens
- $0
- Example workload
- $0 · 1M in + 250K out
Call it from any OpenAI SDK
Use the official SDK with a custom base URL. The example below is complete — swap the model id to hit a different model in the catalog.
curl https://api.apiraven.com/v1/rerank \
-H "Authorization: Bearer $APIRAVEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "baai/bge-reranker-v2-m3",
"query": "What is unified inference?",
"documents": ["One key for every model.", "APIRaven routes across providers."],
"top_n": 2
}'Standardized parameters
Parameters behave the same on every backend. Values that cannot be honored are either mapped to the closest equivalent or safely dropped — never silently corrupted.
| Parameter | Type | Default | Range | Status |
|---|---|---|---|---|
| Core | ||||
query | string | — | — | Supported |
documentsUp to 1,000 documents per request. | string[] | — | — | Supported |
top_n | integer | all | — | Supported |
| Output | ||||
return_documents | boolean | true | — | Supported |
Using bge-reranker v2 m3 on APIRaven
Which provider actually runs my request?+
APIRaven routes each request across a pool of managed inference backends. The model id, request shape and response are identical no matter which backend serves it — you never manage provider accounts, keys or regions.
Is the API OpenAI-compatible?+
Yes. Point any OpenAI SDK at https://api.apiraven.com/v1 with your APIRaven key. Chat, vision, images, embeddings and audio all follow the OpenAI request and response shapes.
What happens when a backend degrades?+
Requests are retried and failed over automatically before the first token is returned. If a model is temporarily unavailable, the API returns one stable error envelope instead of a provider-specific failure.
How is usage billed?+
Per token for text, per image for generation and per minute for transcription — deducted from your APIRaven balance. Every response includes normalized usage so you can meter cost per request.
Ship with baai/bge-reranker-v2-m3
One base URL, one balance, every model. Point your OpenAI SDK at APIRaven and switch models with a single string.