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

# VoyageAI by MongoDB: rerank-2.5

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

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

rerank-2.5 ordnet eine bereitgestellte Menge von Textkandidaten nach Relevanz zu einer Anfrage und optionalen natürlichsprachlichen Anweisungen neu. Es ist ein mehrsprachiger, qualitätsorientierter Reranker mit einem Anfrage-Dokument-Kontext von 32.000 Token und gereihten Werten, die den ursprünglichen Kandidatenindizes zugeordnet sind.

- [**Ailoot Ultra · Neusortierung** `POST /v1/rerank` `voyageai/rerank-2.5`](https://ailoot.ai/models/de-at/voyageai-rerank-2-5/#method-0)

Über das Modell

Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.

rerank-2.5 ist der anweisungsfolgende Reranker von Voyage AI zur Verfeinerung einer Menge von Suchkandidaten. Er untersucht Anfrage und jedes Dokument gemeinsam als Cross-Encoder und gibt anschließend eine Relevanzreihenfolge zurück. Die Veröffentlichung des Herstellers betont natürlichsprachliche Kontrolle darüber, was als relevant zählt, mehrsprachigen Abruf und einen längeren Anfrage-Dokument-Kontext als bei der vorherigen Ausgabe rerank-2.

#### Dem Modell die zu vergleichenden Kandidaten geben

Die Eingabe ist eine Anfrage und eine Liste möglicher Textdokumente. Dies können Textstellen sein, die eine Embedding-Suche oder eine lexikalische erste Suchstufe ausgewählt hat. Der Reranker bewertet den bereitgestellten Text, statt Korpus-Embeddings zu erstellen; seine praktische Aufgabe ist somit, die von der ersten Suche bereits gefundenen Kandidaten zu verfeinern.

Bewahren Sie beim Vorbereiten dieser Liste die ursprüngliche Kandidatenreihenfolge und die Quellenkennungen. Die zurückgegebenen Indizes beziehen sich auf diese Eingabepositionen. Stellen Sie bei einer RAG-Aufgabe die Textstellen bereit, die die Antwortstufe tatsächlich verwenden könnte, einschließlich Titel oder Bedingungen, die zu ihrer Interpretation nötig sind. Ein relevantes Dokument, das in der eingereichten Kandidatenmenge fehlt, kann nicht als neu gefundenes Reranking-Ergebnis erscheinen.

#### Den gewünschten Relevanzbegriff festlegen

Anweisungen können der Anfrage vorangestellt oder angehängt werden. Die Veröffentlichung beschreibt drei hilfreiche Rollen: einen bestimmten Dokumentteil hervorheben, einen Quellentyp bevorzugen und die Anfrage mit Anwendungskontext eindeutig machen. Diese verändern die dem Modell gestellte Relevanzaufgabe.

Eine beispielhafte Anweisung für eine technische Suche lautet: „Priorisiere Textstellen, die Fehler- und Wiederherstellungsverhalten erklären; einführende Übersichten sind nachrangig.“ Geben Sie für eine Forschungssammlung an, ob Titel, Methode oder Ergebnis am wichtigsten sind. Nennen Sie bei einem mehrdeutigen Begriff das Themengebiet der Suche. Halten Sie Frage und Anweisung miteinander vereinbar, damit nicht die eine nach einem breiten Thema fragt, während die andere die Aufgabe stillschweigend verändert.

Diese Präferenzen steuern die Relevanzbewertung. Hat die Anwendung strikte Zulässigkeitsanforderungen – etwa Quellversion, Datum oder Zugriffsbereich –, bereiten Sie die zulässige Kandidatenmenge separat vor. Die Relevanzanweisung des Modells und eine deterministische Beschränkung der Sammlung dienen unterschiedlichen Zwecken.

#### Gereihte Ausgabe und spätere Ergebnisverwendung

Ergebnisse sind nach absteigender Relevanz geordnet und enthalten einen Gleitkomma-Relevanzwert sowie den ursprünglichen Eingabeindex des Kandidaten. Die Option top-k wählt, wie viele führende Ergebnisse zurückgegeben werden; ohne sie liefert die Herstellerspezifikation Ergebnisse für sämtliche eingereichten Kandidaten. Eine optionale Einstellung return-documents schließt den entsprechenden Quelltext ein; andernfalls enthält die Antwort Indizes und Werte.

Verwenden Sie die Reihenfolge zur Auswahl von Textstellen für die Anzeige oder eine spätere Antwortstufe und halten Sie ihre Quellenidentität intakt. Prüfen Sie bei der Bewertung des Rankings den tatsächlichen Text: Der Wert misst die Relevanz zur eingereichten Anfrage, er ist keine generierte Antwort und keine Bestätigung der Richtigkeit der Dokumentaussagen. Dadurch eignet sich das Modell zur Verfeinerung technischer, rechtlicher, finanzieller, medizinischer, dialogbezogener und mehrsprachiger Suchmaterialien, ohne aus dem Ranking eine fachliche Schlussfolgerung zu machen.

#### Kontext, Gesamttokenbudget und Kürzung

Die dokumentierte Anfragegrenze beträgt 8.000 Token einschließlich der in der Anfrage platzierten Anweisungen. Die Anfrage plus jedes einzelne Kandidatendokument muss innerhalb von 32.000 Token bleiben; die Dokumentliste darf höchstens 1.000 Elemente enthalten. Das Gesamtbudget beträgt 600.000 Token, gezählt als Anfrage-Token multipliziert mit der Dokumentanzahl plus sämtliche Dokument-Token. Eine lange Anweisung wird daher über die Kandidatenpaare hinweg wiederholt gezählt.

Die Ausgabeanzahl top-k verändert nicht die Zahl der Kandidaten in dieser Eingabe-Tokenberechnung. Die standardmäßige Kürzung verkürzt zu lange Anfragen oder Dokumente auf die Kontextgrenze; ihre Deaktivierung führt bei einer zu langen Anfrage oder einem zu langen Paar zu einem Fehler. Bereiten Sie antwortrelevante Textstellen gezielt vor und behalten Sie die relevante Bedingung innerhalb des Texts, den das Modell sehen wird. Bewerten Sie die verfeinerte Reihenfolge anhand repräsentativer Fragen und Anweisungen und geben Sie anschließend die ausgewählten ursprünglichen Textstellen an die nächste Stufe weiter.

**Ailoot Ultra · Neusortierung** `POST /v1/rerank` `voyageai/rerank-2.5`

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

VoyageAI by MongoDB /`voyageai/rerank-2.5`

### Einstieg

rerank-2.5 ordnet eine bereitgestellte Menge von Textkandidaten nach Relevanz zu einer Anfrage und optionalen natürlichsprachlichen Anweisungen neu. Es ist ein mehrsprachiger, qualitätsorientierter Reranker mit einem Anfrage-Dokument-Kontext von 32.000 Token und gereihten Werten, die den ursprünglichen Kandidatenindizes zugeordnet sind.

Zulässige Eingaben

Text

Ergebnisse

Nach Relevanz geordnete Ergebnisse

### In Ailoot verfügbar · Eingaben und Methoden

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

Eingabe

`text`

Ausgabe

`rerank`

Ausgabeformat

json

| Feld | Typ | Anforderung | Werte und Limits | Standard |
| --- | --- | --- | --- | --- |
| Feld`documents` | Typ`array` | AnforderungErforderlich | Werte und Limits | Standard— |
| Feld`model` | Typ`string` | AnforderungErforderlich | Werte und Limits voyageai/rerank-2.5 | Standard— |
| Feld`provider` | Typ`schema` | AnforderungOptional | Werte und Limits | Standard— |
| Feld`query` | Typ`string` | AnforderungErforderlich | Werte und Limits | Standard— |
| Feld`session_id` | Typ`string` | AnforderungOptional | Werte und Limits | Standard— |
| Feld`top_n` | Typ`integer` | AnforderungOptional | Werte und Limits Minimum: 1 | Standard— |
| Feld`trace` | Typ`schema` | AnforderungOptional | Werte und Limits | Standard— |
| Feld`user` | Typ`string` | AnforderungOptional | Werte und Limits | Standard— |
| Feld`documents[].text` | Typ`string` | AnforderungOptional | Werte und Limits | Standard— |
| Feld`documents[].image` | Typ`string` | AnforderungOptional | Werte und Limits | Standard— |

Kombinationen von Eingabematerialien

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

Methodenparameter und Lebenszyklus

| Parameter | Vertrag |
| --- | --- |
| Parameter`content_type` | Vertragapplication/json |
| Parameter`required` | Vertragmodel, query, documents |
| Parameter`material_types` | Vertragtext |
| Parameter`optional_controls` | Vertragprovider, session\_id, top\_n, trace, user |
| Parameter`multimodal_input_binding` | Vertragnull |

Lebenszyklus: `synchronous`

Senden Sie die exakte Modell-ID und bewahren Sie die vollständige native Antwort auf.

### Tarife

Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.

Schnellmodus

Nicht angegeben Wenn der Schnellmodus ausgewählt ist

Flex-Modus

Nicht angegeben Wenn der Modus flex ausgewählt ist

Maximaler Denkaufwand

Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird

#### Ailoot-Tarife

#### Preise nach Konfiguration

Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.

| Konfiguration | Tarifstaffel | Abrechnungseinheit | Gebühr |
| --- | --- | --- | --- |
| KonfigurationBasistarife für Tokens | TarifstaffelGrundtarif | Abrechnungseinheit— | Gebühr Eingabe · Eingabetoken **—** / 1K Tokens Ausgabe · Ausgabetoken **—** / 1K Tokens Eingabe · Cache lesen **—** / 1K Tokens Eingabe · In Cache schreiben **—** / 1K Tokens Eingabe · In Cache schreiben, 1 Stunde **—** / 1K Tokens |
| KonfigurationUltra | Tarifstaffel— | Abrechnungseinheit/ 1K Tokens | Gebühr Eingabe **$0.0001** / 1K Tokens |

Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschließenden Verbrauchsdatensatzes. [So funktionieren Reservierung und Abrechnung →](https://ailoot.ai/docs/de-at/billing/reserve/)

### Beispielanfragen

#### Ailoot Ultra · Neusortierung

Beibehaltene offizielle Anfragestruktur; Beispiel zur DokumentationEigene reale Anfrageinhalte verwenden und das vollständige Ergebnis speichern

```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
```

### Ergebnisse abrufen und speichern

#### Ailoot Ultra · Neusortierung

json

##### Alle fertiggestellten Ergebnisse aufbewahren

Bewahren Sie jede vollständig zurückgegebene Antwort, Datei und jeden Inhaltsteil auf.

Jeder tatsächliche Ergebnisindex, jeder endliche relevance\_score und jedes ursprüngliche Dokumentobjekt bleiben erhalten. Die Indizes verweisen auf das ursprüngliche Dokumentarray. Das gesamte ursprüngliche JSON wird gespeichert und erst nach der Abrechnung zurückgegeben.

##### Wenn die ursprüngliche Antwort geprüft werden muss

Bewahren Sie den ursprünglichen Vorgang und die vollständige oder teilweise Antwort auf; wiederholen Sie POST nicht.

Antwortfelder

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

Fehler und nächste Schritte

| Antwort | Bedingung | Nächster Schritt |
| --- | --- | --- |
| Antwort400 · `invalid_request_error` | BedingungUngültiges Pflichtfeld, ungültige Darstellung oder ungültiger Wert | Nächster SchrittKorrigieren Sie das angegebene Anfragefeld. |

### Aliasnamen

#### Modellaliasnamen

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

#### Aliasnamen für Methodenpfade

Verwenden Sie die oben angezeigten Methodenpfade.

#### Zugehörige Aufrufer-IDs

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

FAQ · VoyageAI by MongoDB: rerank-2.5

Welche Eingaben und Ergebnisse sind verfügbar?

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

Welche Felder verwendet die Anfrage?

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

Welche Grenzen gelten?

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

Verbinden Sie Ailoot mit Claude Code, OpenCode, Hermes oder Ihrer eigenen Anwendung.

## Das Unternehmen und sein Projektportfolio

Das Unternehmen und sein Projektportfolio: Millionen von Kunden; monatliche Umsätze in Milliardenhöhe.

## Tokens mit Rabatt kaufen.

Aborabatt für regelmäßige Arbeit. Aktionscodes bieten bis 50% beim Tokenkauf.

Abo

Wählen Sie einen Tarif mit Rabatt für Ihre regelmäßigen Anfragen.

Aktionscode bis 50%

Geben Sie den Code beim Kauf ein. Der Preis wird nach den gültigen Aktionsbedingungen berechnet.

Ausgaben in der Historie

Modell, Tokens und Betrag werden für jede Anfrage gespeichert.

[Abo wählen](https://ailoot.ai/docs/de-at/billing/subscriptions/) · [Modellpreise ansehen](https://ailoot.ai/models/de-at/)

## Verbinden Sie die API mit dem Produkt, das Sie verkaufen.

SaaS, Anwendungen und Bots nach dem offiziellen Angebot und Lizenzvertrag von Ailoot. Fordern Sie für den Weiterverkauf eine Reseller-Lizenz an.

Kommerzielle Anwendung

Integrieren Sie Text-, Bild-, Video- und Audioerzeugung in kostenpflichtige Funktionen Ihres Dienstes.

Reseller-Lizenz

Senden Sie Projektbeschreibung und Zugangsmodell. Fordern Sie schriftliche Nutzungs- und Weiterverkaufsbedingungen an.

Dokumente auf der Website

Offizielles Angebot, Lizenzvertrag und Datenschutzerklärung sind vor der Verbindung zugänglich.

[Reseller-Lizenz anfordern](mailto:support@ailoot.ai) · [Offizielles Angebot und Lizenzvertrag](https://ailoot.ai/legal/offer?lang=de-at)

## Ailoot · Das Unternehmen und sein Projektportfolio





Ailoot baut auf bewährte Betriebserfahrung, einen großen Kundenstamm, stabilen Service und kontinuierliche KPI-Kontrolle.





Das Unternehmen und sein Projektportfolio: Millionen von Kunden; monatliche Umsätze in Milliardenhöhe.





Ailoot nutzt diese Betriebserfahrung für den API-Zugang zu KI-Funktionen in Kundenprodukten, Agenten, Anwendungen und Automatisierungen.
