Reranker

Bring the most relevant results to the top.

Reranker API

Explore the API. Make a real request. Use the code in your application.

API Key & UsageMore

Top N

top_n

Number of ranked documents to return.

Return documents

return_documents

Include original document text alongside scores.

Return embeddings

return_embeddings

Include query and document embeddings.

Maximum document length

max_doc_length

Optional per-document token limit.

RequestPOST
curl 'https://chatsax.com/v1/rerank' \
  -X 'POST' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $CHATSAX_API_KEY" \
  --data-binary '{
  "model": "",
  "query": "",
  "top_n": 3,
  "documents": [
    "",
    "",
    ""
  ],
  "return_documents": true
}'
Your response will appear here.

Your API key

Use this key right away. Sign in to manage your account.

v3.5: listwise reranking with hybrid attention
Source: Jina AI

v3.5: listwise reranking with hybrid attention

A 0.6B model considers candidate documents together. Hybrid attention and self-distillation improve efficiency while preserving the v3 request format.

m0: reranking for visual documents
Source: Jina AI

m0: reranking for visual documents

Use a text query to compare text and image candidates in a single ranking, including pages where layout and visual content carry the answer.

What is a reranker?

Fast retrieval gives you a candidate set. A reranker examines those candidates more closely so the most useful context comes first.

What is a reranker?
Source: Jina AI
1

Initial retrieval

Use vectors, keywords, or a hybrid retriever to collect plausible candidates.

2

Reranking

Compare each candidate with the query using a model trained for relevance.

3

Better context

Send the strongest matches to the user or the language model.

Multilingual retrieval

Compare queries and documents across the languages supported by your model.

Functions and code search

Match a natural-language request with useful code, tools, or function descriptions.

Tables and structured data

Rank candidate schemas or structured records before the next reasoning step.

Two ways to get started

Use a hosted API or explore deployment on your own cloud.

Your API key

Use this key right away. Sign in to manage your account.

Toy Experiment
10Million
FreeNo login required
  • Search Foundation
  • Shared token balance
  • Usage tracking
Most popular
Production
1Billion
$50.00one-time purchase
  • All Chatsax APIs
  • Shared token balance
  • Usage tracking
Scale Up
11Billion
$500.00one-time purchase
  • All Chatsax APIs
  • Shared token balance
  • Usage tracking
Log in to manage your balance, keys and billing history.
Rate limits & token usage

Default application keys allow 60 requests per minute and 10,000 requests per day. All keys in an account share its prepaid balance. Usage is settled from provider-reported tokens.

View rate limit details

Deploy in your own environment

API Integrations

Find the provider integration for your vector database, retrieval framework, or application toolkit. Configure your Chatsax endpoint and key where the client supports custom providers.

8 integrations

Reranker, vector search, and BM25

These methods can work together: retrieve candidates efficiently, then improve their order.

RerankerVector searchBM25
Best suited toRefine a candidate setRetrieve semantic matchesRetrieve keyword matches
RepresentationQuery and document interactionStored document vectorsTerms and their frequencies
Query costHigher per candidateEfficient vector lookupEfficient inverted-index lookup
IndexingOften uses an existing candidate listEncode documents before retrievalBuild an inverted index
Language and meaningDetailed relevance matchingSemantic similarityExact vocabulary matches
StrengthFine-grained relevance judgmentsScales semantic candidate retrievalTransparent lexical matching
Trade-offAdds latency after retrievalMay miss subtle query interactionsCan miss synonyms and paraphrases
Try the APITry the API

Learn about reranking

Explore the methods, evaluations, and design choices behind the current models.

Rate limits

Your key’s assigned limits apply alongside the provider’s service capacity. Check the dashboard for the limits currently active on your account.

ServiceMethodUsage basis
ReaderGET / POSTOutput tokens
SearchGET / POSTSearch request and content
EmbeddingsPOSTInput tokens and modalities
RerankerPOSTQuery and candidate documents

Model license self-check

Will you use a hosted API or download model weights?

Frequently asked questions

Reranker

How is reranking usage measured?

Usage depends on the selected model and the query–document inputs. Review the response usage and current pricing before estimating a large workload.

How do the reranker generations differ?

v3.5 and v3 compare documents listwise; m0 supports visual candidates; v2 and earlier models offer other size, language, and architecture trade-offs.

What license applies to model weights?

Open the model card for its published license. API access and permission to run downloaded weights commercially are separate arrangements.

Can queries and documents use different languages?

Multilingual rerankers support cross-language relevance matching. Test the language pairs and document styles important to your application.

How long can each document be?

Limits vary by model. The v3 family also exposes a document-length setting; reduce long candidates or segment them before reranking.

How many documents can I rerank at once?

Use the published API limits and account for the total context of a listwise request. Reducing the candidate set also helps latency.

How should I estimate latency?

Measure representative queries with the model, candidate count, and document lengths used in production. A fixed document count alone is not enough.

Can I deploy a reranker privately?

Available weights and cloud marketplace listings provide deployment paths. Review the model license and the environment’s memory and runtime requirements.

Can I train a domain-specific reranker here?

This playground runs published rerankers. Training or adapting the underlying reranker requires a separate training workflow and licensed model assets.

How should I prepare image candidates?

Choose m0 for image candidates and provide readable source images. Very small text or heavily compressed pages can lose information before ranking.

What is listwise reranking?

A listwise model sees the query and candidate documents together, allowing the score to reflect relationships among the candidates.

Why does the hosted context limit differ?

The serving system balances total request size, throughput, and latency. Follow the API schema rather than assuming the model’s theoretical maximum.

How do rate limits affect reranking?

Both request frequency and input volume can matter. Queue bursts, limit concurrency, and retry transient rate errors with backoff.

Which reranker should I start with?

For text, evaluate v3.5 first. For visual documents, evaluate m0. Use a smaller or older model when its license, runtime, or latency better fits the task.

Ready to build?

Get an API key

API questions

Why is the first request for some models slow?

Some hosted models may need to load or initialize before serving a request. Latency also depends on the input size and current service load. Keep a timeout suited to the workload and inspect errors before retrying.

Can one Chatsax key access several APIs?

A key can access the services assigned to its scopes. Review the key in the dashboard before sharing it with an application.

Where can I review my usage?

Open the key manager to inspect recorded requests, status, latency, and available usage data for the selected key.

What if I lose a key?

Sign in to manage your keys. If a key may be exposed, revoke it and update the applications that use it.

Do keys expire?

Access follows the expiry and status configured for the key. A key that is revoked or expired cannot be used for new requests.

Can tokens be moved between keys?

Use only the transfer options available in your account. Do not assume that provider balances and Chatsax balances are interchangeable.

Can I revoke an API key?

Use the key manager. Revocation stops future access, so update any dependent applications before retiring a key.

Are my documents used to train models?

Check the platform privacy terms and the selected provider’s policy. Avoid sending material your organization has not approved for that service.

How do I handle rate limits?

Use the status and retry information returned by the API. Add backoff and control concurrency instead of continuously retrying the same request.

Can I process a large collection asynchronously?

The batch workflow supports submitting a job, checking its status, and downloading its output when the selected provider completes it.

Is Chatsax operated by Jina AI?

Chatsax is independently operated. The current model APIs are provided by Jina, whose papers and model cards are linked for reference.

Billing questions

Is usage counted by sentences or requests?

Each service has its own metering rules. Reading, search, embedding, and generation can count different units; review the active pricing before use.

How do I get started?

Open the dashboard to receive a visitor key automatically. Sign in when you need account management or token purchases. The account screen shows your available balance and access.

Can an interrupted request consume resources?

The provider may have processed work before the connection ended. Review the recorded usage and billing status rather than inferring them from a closed browser tab.

Which payment methods are available?

The checkout screen displays payment methods available for your region, currency, and account.

Where can I find a receipt or invoice?

Use the billing portal linked from your account, and retain the payment confirmation associated with the purchase.

Does buying API credit grant a model license?

No. API credit pays for hosted usage. Downloading and commercially running model weights follows the model’s separate license.

Can I discuss a larger deployment?

Use the contact page to describe the services, traffic, latency, and deployment requirements you need.

Why is the balance different from what I expected?

Check the selected account and key, the payment status, and the latest usage records. Keep the payment reference when contacting support.

How do I manage future charges?

Use the billing controls provided in the account or payment portal. Check the confirmation after changing an automatic payment setting.