Source: https://ailoot.ai/models/cs/voyageai-rerank-2-5/
Canonical: https://ailoot.ai/models/cs/voyageai-rerank-2-5/
Language: cs

# VoyageAI by MongoDB: rerank-2.5

[Markdown](https://ailoot.ai/models/cs/voyageai-rerank-2-5/index.md) · [JSON](https://ailoot.ai/models/cs/voyageai-rerank-2-5/facts.json)

## [VoyageAI by MongoDB: rerank-2.5](https://ailoot.ai/models/cs/voyageai-rerank-2-5/)

rerank-2.5 mění pořadí dodané sady textových kandidátů podle relevance k dotazu a volitelným pokynům v přirozeném jazyce. Jde o vícejazyčný model pro řazení podle relevance zaměřený na kvalitu s kontextem 32 000 tokenů pro dvojici dotaz–dokument a seřazenými skóre navázanými na původní indexy kandidátů.

- [**Ailoot Ultra · Přeřazení podle relevance** `POST /v1/rerank` `voyageai/rerank-2.5`](https://ailoot.ai/models/cs/voyageai-rerank-2-5/#method-0)

O modelu

Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.

rerank-2.5 je model společnosti Voyage AI pro úpravu pořadí podle pokynů, navržený ke zpřesnění sady vyhledaných kandidátů. Společně zkoumá dotaz a každý dokument jako cross-encoder a poté vrací pořadí podle relevance. Vydání výrobce zdůrazňuje řízení toho, co se považuje za relevantní, přirozeným jazykem, vícejazyčné vyhledávání a delší kontext dvojice dotaz–dokument než u předchozí edice rerank-2.

#### Dodejte modelu kandidáty k porovnání

Vstupem je dotaz a seznam kandidátních textových dokumentů. Mohou to být pasáže vybrané embeddingovým vyhledáváním nebo lexikálním vyhledáváním první fáze. Model pro řazení podle relevance vyhodnocuje dodaný text místo vytváření embeddingů korpusu, takže jeho praktickou úlohou je zpřesnit kandidáty již nalezené počátečním vyhledáváním.

Při přípravě seznamu zachovejte původní pořadí kandidátů a identifikátory zdrojů. Vrácené indexy odkazují na tyto vstupní pozice. U úlohy RAG dodejte pasáže, které by fáze odpovědi mohla skutečně použít, včetně názvu nebo podmínek potřebných k jejich výkladu. Relevantní dokument, který v odeslané sadě kandidátů chybí, se nemůže objevit jako nově nalezený výsledek přehodnocení pořadí.

#### Určete zamýšlené pojetí relevance

Pokyny lze připojit za dotaz nebo před něj. Vydání popisuje tři užitečné role: zdůraznit konkrétní část dokumentu, upřednostnit typ zdroje a odstranit nejednoznačnost dotazu kontextem aplikace. Ty mění úlohu relevance předloženou modelu.

Pro technické vyhledávání je ilustračním pokynem „Upřednostněte pasáže, které vysvětlují chování při selhání a obnově; úvodní přehledy jsou vedlejší.“ U rešeršní sbírky určete, zda nejvíce záleží na názvu, metodě nebo výsledku. U nejednoznačného výrazu uveďte tematickou oblast vyhledávání. Otázku a pokyn udržujte slučitelné, aby jeden nežádal široké téma, zatímco druhý skrytě mění úlohu.

Tyto preference usměrňují hodnocení relevance. Pokud má aplikace přísné požadavky na způsobilost — například verzi zdroje, datum nebo rozsah přístupu — připravte způsobilou sadu kandidátů samostatně. Pokyn modelu k relevanci a deterministické omezení sbírky slouží různým účelům.

#### Seřazený výstup a pozdější použití výsledků

Výsledky jsou seřazeny sestupně podle relevance a obsahují skóre relevance ve formátu s plovoucí řádovou čárkou a původní vstupní index kandidáta. Volba top-k vybírá počet předních výsledků k vrácení; bez ní specifikace výrobce vrací výsledky pro všechny odeslané kandidáty. Volitelné nastavení return-documents zahrnuje odpovídající zdrojový text; jinak odpověď obsahuje indexy a skóre.

Pořadí použijte k výběru pasáží pro zobrazení nebo pozdější fázi odpovědi a zachovejte jejich zdrojovou identitu. Při hodnocení pořadí prozkoumejte skutečný text: skóre je mírou relevance k odeslanému dotazu, nikoli vygenerovanou odpovědí nebo ověřením správnosti tvrzení dokumentu. Model je tak užitečný pro zpřesňování technických, právních, finančních, zdravotnických, konverzačních i vícejazyčných vyhledávaných podkladů, aniž by se pořadí měnilo v odborný závěr.

#### Kontext, celkový rozpočet tokenů a zkracování

Dokumentovaný limit dotazu je 8 000 tokenů včetně pokynů vložených do dotazu. Dotaz a kterýkoli jednotlivý kandidátní dokument se musí vejít do 32 000 tokenů a seznam dokumentů může obsahovat nejvýše 1 000 položek. Celkový limit je 600 000 tokenů, počítaný jako tokeny dotazu násobené počtem dokumentů plus všechny tokeny dokumentů. Dlouhý pokyn se proto započítává opakovaně pro každou dvojici dotaz–dokument.

Počet výstupních výsledků top-k nemění počet kandidátů v tomto výpočtu vstupních tokenů. Výchozí zkracování zkrátí příliš dlouhé dotazy nebo dokumenty tak, aby splnily limit kontextu; jeho vypnutí způsobí u příliš dlouhého dotazu nebo dvojice chybu. Pasáže obsahující odpověď připravujte záměrně a příslušnou podmínku zachovejte v textu, který model uvidí. Zpřesněné pořadí posuďte na reprezentativních otázkách a pokynech a poté vybrané původní pasáže předejte do další fáze.

**Ailoot Ultra · Přeřazení podle relevance** `POST /v1/rerank` `voyageai/rerank-2.5`

[`voyageai/rerank-2.5`](https://ailoot.ai/models/cs/#m=voyageai%2Frerank-2.5&route=Ultra&caller=voyageai%2Frerank-2.5&fmt=rerank)

VoyageAI by MongoDB /`voyageai/rerank-2.5`

### Úvod

rerank-2.5 mění pořadí dodané sady textových kandidátů podle relevance k dotazu a volitelným pokynům v přirozeném jazyce. Jde o vícejazyčný model pro řazení podle relevance zaměřený na kvalitu s kontextem 32 000 tokenů pro dvojici dotaz–dokument a seřazenými skóre navázanými na původní indexy kandidátů.

Přijímané vstupy

Text

Výsledky

Výsledky seřazené podle relevance

### Dostupné v Ailoot · vstupy a metody

**Ailoot Ultra · Přeřazení podle relevance** `POST /v1/rerank`

Vstup

`text`

Výstup

`rerank`

Výstupní formát

json

| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
| --- | --- | --- | --- | --- |
| Pole`documents` | Typ`array` | PožadavekPovinné | Hodnoty a limity | Výchozí— |
| Pole`model` | Typ`string` | PožadavekPovinné | Hodnoty a limity voyageai/rerank-2.5 | Výchozí— |
| Pole`provider` | Typ`schema` | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
| Pole`query` | Typ`string` | PožadavekPovinné | Hodnoty a limity | Výchozí— |
| Pole`session_id` | Typ`string` | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
| Pole`top_n` | Typ`integer` | PožadavekVolitelné | Hodnoty a limity Minimum: 1 | Výchozí— |
| Pole`trace` | Typ`schema` | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
| Pole`user` | Typ`string` | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
| Pole`documents[].text` | Typ`string` | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
| Pole`documents[].image` | Typ`string` | PožadavekVolitelné | Hodnoty a limity | Výchozí— |

Kombinace vstupních materiálů

**text\_rerank** · Povinné: query, documents array with minItems1

Parametry a životní cyklus metody

| Parametr | Kontrakt |
| --- | --- |
| Parametr`content_type` | Kontraktapplication/json |
| Parametr`required` | Kontraktmodel, query, documents |
| Parametr`material_types` | Kontrakttext |
| Parametr`optional_controls` | Kontraktprovider, session\_id, top\_n, trace, user |
| Parametr`multimodal_input_binding` | Kontraktnull |

Životní cyklus: `synchronous`

Odešlete přesné ID modelu a uchovejte celou nativní odpověď.

### Tarify

Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.

Rychlý režim

Neuvedeno Při výběru rychlého režimu

Režim flex

Neuvedeno Při výběru režimu flex

Maximální intenzita uvažování

Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)

#### Sazby Ailoot

#### Ceny podle konfigurace

Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.

| Konfigurace | Tabulka sazeb | Účtovací jednotka | Poplatek |
| --- | --- | --- | --- |
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Účtovací jednotka— | Poplatek Vstup · Vstupní tokeny **—** / 1K tokenů Výstup · Výstupní tokeny **—** / 1K tokenů Vstup · Čtení z mezipaměti **—** / 1K tokenů Vstup · Zápis do mezipaměti **—** / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina **—** / 1K tokenů |
| KonfiguraceUltra | Tabulka sazeb— | Účtovací jednotka/ 1K tokenů | Poplatek Vstup **$0.0001** / 1K tokenů |

Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. [Jak funguje rezervace a vyúčtování →](https://ailoot.ai/docs/cs/billing/reserve/)

### Příklady požadavků

#### Ailoot Ultra · Přeřazení podle relevance

Uchovaná oficiální struktura požadavku; dokumentační příkladPoužijte skutečné podklady svého požadavku a uchovejte úplný výsledek

```json
{
  "documents": [
    "Paris is the capital of France.",
    "Berlin is the capital of Germany."
  ],
  "model": "voyageai/rerank-2.5",
  "query": "What is the capital of France?",
  "top_n": 3
}
```

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"
export AILOOT_REQUEST_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))
if not isinstance(p,dict): raise SystemExit('Request must be a JSON object')
p['model']='voyageai/rerank-2.5'
Path('request.json').write_text(json.dumps(p,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 result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))
PY_RESULT
```

### Přijímání a ukládání výsledků

#### Ailoot Ultra · Přeřazení podle relevance

json

##### Uchovejte všechny dokončené výsledky

Uchovejte každou úplnou vrácenou odpověď, soubor i část obsahu.

Zachovává se každý skutečný index výsledku, konečná hodnota relevance\_score a původní objekt dokumentu. Indexy odkazují na původní pole dokumentů. Celý původní JSON se uloží a vrátí až po vyúčtování.

##### Pokud je nutné ověřit původní odpověď

Zachovejte původní operaci a úplnou či částečnou odpověď; požadavek POST neopakujte.

Pole odpovědi

| Pole | Typ |
| --- | --- |
| Pole`model` | Typstring |
| Pole`id` | Typstring |
| Pole`provider` | Typstring |
| Pole`results[].index` | Typinteger |
| Pole`results[].relevance_score` | Typnumber |
| Pole`results[].document.text` | Typstring |
| Pole`results[].document.image` | Typstring |
| Pole`usage.search_units` | Typinteger |
| Pole`usage.total_tokens` | Typinteger |
| Pole`usage.cost` | Typnumber |

Chyby a další kroky

| Odpověď | Podmínka | Další krok |
| --- | --- | --- |
| Odpověď400 · `invalid_request_error` | PodmínkaNeplatné povinné pole, způsob zadání nebo hodnota | Další krokOpravte označené pole požadavku. |

### Aliasy

#### Aliasy modelu

**Ailoot Ultra** [`voyageai/rerank-2.5`](https://ailoot.ai/models/cs/#m=voyageai%2Frerank-2.5&route=Ultra&caller=voyageai%2Frerank-2.5&fmt=rerank)

#### Aliasy cest metod

Použijte cesty metod uvedené výše.

#### Související ID modelů

[`voyageai/rerank-2.5`](https://ailoot.ai/models/cs/#m=voyageai%2Frerank-2.5&route=Ultra&caller=voyageai%2Frerank-2.5&fmt=rerank)

FAQ · VoyageAI by MongoDB: rerank-2.5

Jaké vstupy a výsledky jsou dostupné?

`POST /v1/rerank` · `voyageai/rerank-2.5`: `text` → `rerank`

Jaká pole požadavek používá?

`POST /v1/rerank` · `voyageai/rerank-2.5`: `documents`, `model`, `provider`, `query`, `session_id`, `top_n`, `trace`, `user`

Jaké limity platí?

`POST /v1/rerank` · `voyageai/rerank-2.5`: `top_n.minimum`: `1`

Připojte Ailoot k Claude Code, OpenCode, Hermes nebo vlastní aplikaci.

## Společnost a její portfolio projektů

Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách.

## Nakupujte tokeny se slevou.

Sleva předplatného pro pravidelnou práci. Promo kódy až 50% na nákup tokenů.

Předplatné

Pro pravidelné požadavky vyberte tarif se slevou.

Promo kód až 50%

Při nákupu zadejte kód. Cena se přepočítá podle probíhající akce.

Výdaje v historii

U každého požadavku se uloží model, tokeny a částka.

[Vybrat předplatné](https://ailoot.ai/docs/cs/billing/subscriptions/) · [Zobrazit ceny modelů](https://ailoot.ai/models/cs/)

## Připojte API k produktu, který prodáváte.

SaaS, aplikace a boti podle nabídky a licenční smlouvy Ailoot. Pro přeprodej požádejte o licenci přeprodejce.

Komerční aplikace

Začleňte generování textu, obrázků, videa a zvuku do placených funkcí své služby.

Licence pro přeprodejce

Pošlete popis projektu a způsob poskytování přístupu. Vyžádejte písemné podmínky použití a přeprodeje.

Dokumenty na webu

Nabídka, licenční smlouva a zásady zpracování dat jsou dostupné před připojením.

[Požádat o licenci přeprodejce](mailto:support@ailoot.ai) · [Nabídka a licenční smlouva](https://ailoot.ai/legal/offer?lang=cs)

## Ailoot · Společnost a její portfolio projektů





Ailoot staví na dlouhodobých provozních zkušenostech, široké klientské základně, stabilních službách a průběžném sledování KPI.





Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách.





Ailoot využívá tyto provozní zkušenosti k poskytování přístupu přes API k funkcím AI v produktech zákazníků, agentech, aplikacích a automatizacích.
