Source: https://ailoot.ai/models/en/jina-reranker-v2-base-multilingual/
Canonical: https://ailoot.ai/models/en/jina-reranker-v2-base-multilingual/
Language: en

# jina-reranker-v2-base-multilingual

[Markdown](https://ailoot.ai/models/en/jina-reranker-v2-base-multilingual/index.md) · [JSON](https://ailoot.ai/models/en/jina-reranker-v2-base-multilingual/facts.json)

## [jina-reranker-v2-base-multilingual](https://ailoot.ai/models/en/jina-reranker-v2-base-multilingual/)

Jina Reranker v2 Base Multilingual scores a query against candidate texts and orders them by relevance. Its cross-encoder handles multilingual retrieval, while the maker's reranking helper chunks longer documents around a 1,024-token model window.

- [**Ailoot Ultra · Rerank** `POST /v1/rerank` `jina-reranker-v2-base-multilingual`](https://ailoot.ai/models/en/jina-reranker-v2-base-multilingual/#method-0)

About the model

This description covers the model’s capabilities. Available in Ailoot inputs, outputs and options are listed for the selected method below.

Jina Reranker v2 Base Multilingual is a text-ranking model for the second stage of retrieval. Give it a query and candidate documents or passages; it evaluates each query–document pair and returns a relevance score. The useful result is a better-ordered candidate set for search or a retrieval-augmented workflow. It does not write the answer to the query or create document embeddings.

#### Prepare the query and the candidate passages

Write the query so that it states the information need. Then provide the texts that an earlier retrieval step has found. Keep a stable identifier beside each candidate so that its relevance score can be connected to the original document, section or record.

For a support search, use the actual question and candidate excerpts that contain the relevant procedure. A query about resetting a particular device should be paired with passages that retain the device name, version and reset conditions. A passage that merely mentions the device can be less useful than one that explains the requested operation. Supply the content the model needs to compare, rather than only a document title.

Use coherent passages. A table heading, definition or exception can change how a paragraph relates to the query, so do not remove it merely to make every candidate equally short. The reranker evaluates supplied candidates; it cannot recover a relevant document that the earlier retrieval stage omitted.

#### Query–document scoring

This is a cross-encoder: the query and a candidate text are processed together. The direct scoring interface returns a floating-point relevance score for each corresponding pair. Higher scores indicate greater relevance in that comparison. The score is a ranking signal, rather than a generated explanation or proof that the document is true.

The maker also provides a reranking helper that returns ordered documents with their scores. A top-result control selects how many ranked candidates to retain. Preserve their identifiers and text when passing them into the next stage. For a question-answering workflow, the following model still needs the query and the selected evidence; the ranked list itself is not an answered question.

When comparing retrieval changes, keep the query and evaluation criteria fixed. Inspect whether the passages promoted to the top actually contain the requested information. Set any filtering threshold using examples from your own collection, instead of treating a relevance score as a universal measure of answer correctness.

#### Model window and longer documents

The model supports a context length of up to 1,024 tokens. Its documented `rerank()` helper handles longer documents with a sliding-window approach, scores the pieces separately and combines them into document-level results. Chunking is behavior of that helper; it should not be confused with a single model input that has an unlimited context window.

The helper exposes query-length and chunk-length controls and an overlap setting. Its documented default overlap is 80. The published usage example specifies a maximum query length of 512 and a chunk length of 1,024; these are example helper settings that should be kept distinct from a promise that every caller or route uses them.

For a long manual, retain enough nearby text for an instruction and its conditions to appear together. When assessing the result, inspect the relevant portion of a highly ranked document rather than assuming that every section of it answers the query equally well.

#### Multilingual and specialized text retrieval

The v2 model is multilingual. The maker's examples rank English queries against English, German, Spanish, Chinese and Japanese passages. This supports a collection where relevant material is written in several languages without requiring every candidate to be translated into the query's language first.

The documented task scope also includes code retrieval and ranking text representations related to functions or SQL. These remain relevance-ranking tasks: the model evaluates the supplied text. It does not execute a function, run SQL or produce a tool result merely because those kinds of candidates appear in the retrieval set.

#### Edition and practical limits

Keep this v2 Base Multilingual profile separate from Jina's earlier English-only reranker, Jina Reranker v3 and multimodal reranking profiles. They are different models with different task and input characteristics. This profile's input is query–text pairs; image or video content needs its own suitable representation or model.

The maker's reference implementation supports direct scores and a document-ranking helper, with optional accelerated attention. Those implementation choices affect the way inputs are prepared and processed; they do not establish that every integration exposes identical controls.

Use the ranked output for multilingual search, support knowledge bases, document retrieval and evidence selection before generation. Review the top passages, keep the original candidate mapping and distinguish relevance from factual validity. A useful retrieval result brings the right supplied evidence forward while leaving the next task—answering, summarizing or deciding—to the appropriate workflow.

**Ailoot Ultra · Rerank** `POST /v1/rerank` `jina-reranker-v2-base-multilingual`

[`jina-reranker-v2-base-multilingual`](https://ailoot.ai/models/en/#m=jina-reranker-v2-base-multilingual&route=Ultra&caller=jina-reranker-v2-base-multilingual&fmt=rerank)

Jina AI /`jina-reranker-v2-base-multilingual`

### Overview

Jina Reranker v2 Base Multilingual scores a query against candidate texts and orders them by relevance. Its cross-encoder handles multilingual retrieval, while the maker's reranking helper chunks longer documents around a 1,024-token model window.

Accepted inputs

Text

Results

Ranked results

### Available in Ailoot · inputs & methods

**Ailoot Ultra · Rerank** `POST /v1/rerank`

Input types

`text`

Output types

`rerank`

| Field | Type | Requirement | Values & limits | Default |
| --- | --- | --- | --- | --- |
| Field`model` | Type`string` | RequirementRequired | Values & limits jina-reranker-v2-base-multilingual | Default— |
| Field`query` | Type`string` | RequirementOptional | Values & limits | Default— |
| Field`documents` | Type`array` | RequirementRequired | Values & limits | Default— |

Method parameters and lifecycle

| Parameter | Contract |
| --- | --- |
| Parameter`content_type` | Contractapplication/json |
| Parameter`required` | Contractmodel, documents |
| Parameter`material_types` | Contracttext |
| Parameter`material_conditions` | ContractSet your actual query and nonempty array of original text documents. Result indices refer to that original array. |

Lifecycle: `synchronous_result_then_owned_library`

`GET /v1/media/assets/{asset_id}/content`

`GET /v1/media/assets`

`GET /v1/media/assets/{asset_id}`

### Pricing

Tariff references do not add request options. Supported parameters are listed for the selected method.

Fast mode

Not specified When fast mode is selected

Flex mode

Not specified When flex mode is selected

Maximum reasoning effort

Not specified When maximum reasoning effort uses the default adjustment

#### Ailoot rates

#### Prices by configuration

Match each charge to the conditions shown. Use one rate for each set of alternative configurations.

| Configuration | Rate schedule | Billing unit | Charge |
| --- | --- | --- | --- |
| ConfigurationBase token rates | Rate scheduleBase rate | Billing unit— | Charge Input · Input tokens **—** / 1K tokens Output · Output tokens **—** / 1K tokens Input · Cache read **—** / 1K tokens Input · Cache write **—** / 1K tokens Input · Cache write, 1 hour **—** / 1K tokens |
| Configurationtotal token | Rate schedule— | Billing unit/ 1K tokens | Charge Input · total token **$0.0001** / 1K tokens |

Ailoot reserves an estimated amount before a request. After the result, it settles the final charge from measured usage. Streaming settlement uses the final usage record. [How reservation and settlement work →](https://ailoot.ai/docs/en/billing/reserve/)

### Example requests

#### Ailoot Ultra · Rerank

Use actual input and retain the complete result

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_QUERY:?Set the actual documented input value}"
export AILOOT_QUERY
: "${AILOOT_DOCUMENTS_JSON:?Set the actual documented input value}"
export AILOOT_DOCUMENTS_JSON
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'jina-reranker-v2-base-multilingual', 'query': '${ACTUAL_QUERY}', 'documents': '${ACTUAL_DOCUMENTS}'}
request['query']=os.environ['AILOOT_QUERY']
request['documents']=json.loads(os.environ['AILOOT_DOCUMENTS_JSON'])
Path('request.json').write_text(json.dumps(request,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/rerank \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o response.bin
# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.
```

### Receive and save results

#### Ailoot Ultra · Rerank

Complete original native JSON result with the configured response model, original document indices, relevance scores, document strings and native token usage. Retain every actual result and usage field.

- `GET /v1/media/assets/{asset_id}/content`
- `GET /v1/media/assets`
- `GET /v1/media/assets/{asset_id}`

##### Keep all completed results

Keep every complete returned response, file and content part.

Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.

##### If the original response needs checking

Retain the actual X-Client-Request-ID and complete response. Read the original owned assets and their exact signed content URLs; never resubmit an uncertain creation.

Response fields

| Field | Type | Meaning |
| --- | --- | --- |
| Field`model` | Typestring | MeaningExact response model required by the configured Source consumer. |
| Field`results[].index` | Typeinteger | MeaningUnique original input document index. |
| Field`results[].relevance_score` | Typenumber | MeaningFinite relevance score. |
| Field`results[].document` | Typestring | MeaningOriginal text document required by this configured response consumer. |
| Field`usage.total_tokens` | Typeinteger | MeaningFinite nonnegative native token count required by the current accepted tariff. |

Errors and next steps

| Response | Condition | Next step |
| --- | --- | --- |
| Response400 · `invalid_request_error` | ConditionThe JSON body or explicit canonical model ID is invalid. | Next stepRetain the response and correct the indicated request field. |
| Response401 · `authentication_error` | ConditionThe Ailoot API key is invalid. | Next stepUse your authorized Ailoot API key. |
| Response403 · `permission_error` | ConditionThe key group does not admit this method. | Next stepRetain the returned error details. |
| Response404 · `not_found_error` | ConditionThe selected method has no admitted route. | Next stepRetain the returned error details. |
| Response422 · `price_unavailable` | ConditionThe accepted tariff cannot obtain its required input quantity or bound. | Next stepRetain the response; use the input representation required by the accepted tariff. |
| Response503 · `` | ConditionRequired storage, route, method price or reservation is unavailable. | Next stepKeep the complete original response. An uncertain reservation is not permission to resubmit. |
| Response502 · `billing_requires_check` | ConditionThe original result, usage or settlement requires checking. | Next stepRetain the actual request ID and original response. Read the existing owned record; do not resubmit creation. |

### Aliases

#### Model aliases

**Ailoot Ultra** [`jina-reranker-v2-base-multilingual`](https://ailoot.ai/models/en/#m=jina-reranker-v2-base-multilingual&route=Ultra&caller=jina-reranker-v2-base-multilingual&fmt=rerank)

#### Method path aliases

Use the method paths shown above.

#### Related caller IDs

[`jina-reranker-v2-base-multilingual`](https://ailoot.ai/models/en/#m=jina-reranker-v2-base-multilingual&route=Ultra&caller=jina-reranker-v2-base-multilingual&fmt=rerank)

FAQ · jina-reranker-v2-base-multilingual

What inputs and results are available?

`POST /v1/rerank` · `jina-reranker-v2-base-multilingual`: `text` → `rerank`

Which fields does the request use?

`POST /v1/rerank` · `jina-reranker-v2-base-multilingual`: `model`, `query`, `documents`

Connect Ailoot to Claude Code, OpenCode, Hermes or your own app.

## The company and its project portfolio

The company and its project portfolio: millions of customers; monthly sales in the billions.

## Buy tokens at a discount.

Subscription discounts for regular use. Promo codes offer up to 50% off token purchases.

Subscription

Choose a discounted plan for your regular requests.

Promo code: up to 50% off

Enter your code at checkout. The price updates to reflect the current promotion.

Spending in your history

The model, tokens and amount are recorded for each request.

[Choose a subscription](https://ailoot.ai/docs/en/billing/subscriptions/) · [View model prices](https://ailoot.ai/models/en/)

## Connect the API to a product you sell.

Use Ailoot in SaaS, apps and bots under its official service offer and licence agreement. Request a reseller licence for resale.

Commercial application

Add text, image, video and audio generation to paid features in your service.

Reseller licence

Send a description of your project and how you provide access. Request written terms for use and resale.

Documents on the website

The service offer, licence agreement and data processing policy are available before you connect.

[Request a reseller licence](mailto:support@ailoot.ai) · [Service offer and licence agreement](https://ailoot.ai/legal/offer?lang=en)

## Ailoot · The company and its project portfolio





Ailoot combines established operating experience, a large client base, stable service and ongoing KPI control.





The company and its project portfolio: millions of customers; monthly sales in the billions.





Ailoot brings that operating experience to API access for AI features in customer products, agents, applications and automations.