Modelle

VoyageAI by MongoDB: rerank-3

Markdown · JSON

VoyageAI by MongoDB: rerank-3

Voyage rerank-3 ist die qualitätsorientierte Rerank-3-Ausgabe zur Bewertung der Relevanz von Anfrage-Dokument-Paaren. Sie ordnet abgerufene Textkandidaten neu, unterstützt natürlichsprachliche Relevanzanweisungen und verarbeitet Paare mit 32.000 Token für die Suche in langen Dokumenten, Code und Wissensbasen.

Ü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.

Voyage rerank-3 ist ein Text-Reranker zur Verbesserung der Qualität abgerufener Belege. Es erhält eine Anfrage und eine Liste von Kandidatendokumenten, untersucht jedes Paar gemeinsam und gibt die Kandidaten nach Relevanz geordnet zurück. Embeddings und Stichwortsuche können eine große Sammlung zunächst auf eine handhabbare engere Auswahl begrenzen; rerank-3 bewertet deren Relevanz anschließend detaillierter. Seine Ausgabe sind bewertete Suchbelege, die eine Anwendung anzeigen oder an eine separate Antwortgenerierungsstufe weitergeben kann.

Qualitätsorientiertes Rerank 3 Der Hersteller positioniert rerank-3 als genauigkeitsorientierte Ausgabe und rerank-3-lite als Ausgabe für latenzempfindliche Suche. Die dritte Generation aktualisiert Grundarchitektur und Trainingsmischung, mit besonderen Verbesserungen beim Abruf langer Dokumente und von Quellcode gegenüber den jeweiligen 2.5-Vorgängern. Der Anbieter bewertet das Modell anhand von technischer Dokumentation, Code, mehrsprachigem Material und anderen Dokumentbereichen. Diese Ergebnisse stützen seine Abrufrolle; wählen Sie die Ausgabe anhand der Fragen und Kandidatendokumente, die für Ihre eigene Sammlung wichtig sind.

Lange Dokumente mit genügend Kontext Ein langer Kandidat kann weit über seinen einleitenden Absatz hinaus hilfreichen Kontext enthalten. Stellen Sie einen zusammenhängenden Abschnitt oder ein Dokument mit Titel und relevantem umgebendem Material bereit, damit das Modell beurteilen kann, wie die tatsächliche Frage zum Inhalt passt. Bewahren Sie bei einer Suche nach Produktrichtlinien die Überschriften und Ausnahmen rund um die betreffende Textstelle. Stammen mehrere abgerufene Abschnitte aus derselben Quelle, behalten Sie Dokument- und Abschnittskennungen bei; die Anwendung kann dann zeigen, woher die ausgewählten Belege stammen.

Das Kontextfenster wird von Anfrage und jedem Kandidaten gemeinsam genutzt. Der aktuelle Herstellerleitfaden nennt 32.000 Token für dieses Paar, einschließlich einer Anfrage mit höchstens 8.000 Token. Eine Anfrage mit 3.000 Token lässt somit höchstens 29.000 Token für jedes Dokument übrig. Bereiten Sie die Eingabe so vor, dass ihre wesentlichen Inhalte hineinpassen, besonders wenn eine lange Einleitung oder wiederholte Standardtexte sonst das Fenster belegen würden. Die dokumentierte Kürzungsoption ist standardmäßig aktiviert und kann übergroße Anfrage- oder Dokumenttexte vor der Bewertung kürzen. Prüfen Sie, was erhalten bleibt, wenn die Position einer Textstelle wichtig ist.

Code und technischer Abruf Für die Abrufstufe eines Programmierassistenten können Kandidaten Funktionsimplementierungen, API-Dokumentation oder technische Erklärungen als Text enthalten. Ergänzen Sie die Symbole, Signaturen und den Kontext, die zur Unterscheidung ähnlicher Kandidaten nötig sind. Eine Anfrage wie „Finde die Funktion, die Pfade normalisiert und dabei ein abschließendes Trennzeichen beibehält“ nennt ein konkretes abzugleichendes Verhalten. Fügen Sie relevante Sprach-, Plattform- oder Versionsbedingungen hinzu. Prüfen Sie nach dem Ranking den ausgewählten Code und seine Abhängigkeiten, bevor Sie ihn als Kontext verwenden; ein Relevanzwert belegt nicht, dass eine Implementierung jede genannte Anforderung erfüllt.

Anweisungen definieren Relevanz Das Modell behält die mit Rerank 2.5 eingeführte Fähigkeit zum anweisungsbasierten Reranking bei. Stellen Sie der Anfrage eine knappe Anweisung voran oder hängen Sie sie an, wenn die Nutzerabsicht präzisiert werden muss. Erklären Sie bei der Suche nach Forschungsdokumenten, ob Titel, eine bestimmte Methode oder ein Anwendungsbereich im Mittelpunkt stehen. Geben Sie für einen internen Katalog an, ob die Anfrage Installation, Fehlerbehebung oder Kompatibilität betrifft. Halten Sie diese Anweisung mit der Frage im Einklang; zusätzliche Präferenzen, die der Hauptanfrage widersprechen, können verändern, was das Ranking zu optimieren versucht.

Kandidatendokumente und Budgets vorbereiten Die Eingabe ist eine Liste von Textzeichenfolgen. Extrahieren Sie verwendbaren Text aus Quelldokumenten, bewahren Sie sinnvolle Abschnittsgrenzen und halten Sie neben der Liste eine geordnete Datensatzzuordnung vor. Der Hersteller erlaubt bis zu 1.000 Dokumente in einer Anfrage. Er nennt außerdem eine gesamte Eingabeobergrenze von 600.000 Token: Anfrage-Token multipliziert mit der Dokumentanzahl plus die Summe aller Dokument-Token. Dies unterscheidet sich von der Kontextgrenze pro Paar. Das Reduzieren redundanten Anfragetexts kann sowohl Paarkapazität als auch Gesamtbudget der Anfrage bewahren.

Zählen Sie Token für das betreffende Modell, statt Wort- oder Zeichenzahl mit Tokenzahl gleichzusetzen. Wählen Sie bei großen Kandidaten zusammenhängende Textstellen aus oder teilen Sie das Material nach hilfreichen Überschriften auf und behalten Sie Angaben zur übergeordneten Quelle bei. Reranking ist am hilfreichsten, nachdem die erste Suche bereits plausible Kandidaten gefunden hat: Es kann keine fehlende Quelle reihen, die nie in die Liste gelangt ist.

Gereihte Ergebnisse und nachgelagerte Nutzung Das Ergebnis enthält Relevanzwerte und Indizes, die sich auf die ursprünglichen Eingabedokumente beziehen, sortiert in absteigender Relevanzreihenfolge. Die Option top_k begrenzt die Anzahl der zurückgegebenen gereihten Ergebnisse; andernfalls werden alle Eingabekandidaten zurückgegeben. Die REST-Schnittstelle des Herstellers erlaubt außerdem, den Dokumenttext einzuschließen. Verwenden Sie jeden ursprünglichen Index, um Titel, Quellenkennung und alle von Ihrer Anwendung benötigten Metadaten wiederzufinden, und zeigen Sie anschließend die ausgewählten Elemente an oder nehmen Sie den relevanten Text in den Belegkontext einer Antwort auf.

Prüfen Sie die besten Ergebnisse anhand der Frage und halten Sie die Quellenidentität sichtbar. Ein hoher relativer Rang bestätigt nicht die sachliche Richtigkeit eines Dokuments, und eine engere Auswahl ausschließlich schlechter Kandidaten hat trotzdem ein erstes Element. Trennen Sie die Relevanzauswahl von der Entscheidung, ob die ausgewählten Belege zur Beantwortung der Nutzerfrage ausreichen.

Wechsel der Ausgabe Der Hersteller beschreibt rerank-3 als direkt einsetzbaren Nachfolger von rerank-2.5 mit derselben API-Semantik und Werten, die auf die Verteilung des jeweiligen Vorgängers kalibriert sind. Diese Kompatibilität unterstützt das Beibehalten einer vorhandenen Abrufstufe und Datensatzzuordnung. Vergleichen Sie aussagekräftige Ergebnisreihenfolgen und jeden Schwellenwert anhand des aktuellen Korpus, bevor Sie sich auf den Wechsel verlassen. Halten Sie rerank-3 und rerank-3-lite als getrennte Auswahlmöglichkeiten bei: Gemeinsame Grenzen und das Befolgen von Anweisungen machen ihre Qualitäts- und Latenzprioritäten nicht identisch.

Ailoot Ultra · Neusortierung POST /v1/rerank voyageai/rerank-3

voyageai/rerank-3

VoyageAI by MongoDB /voyageai/rerank-3

Einstieg

Voyage rerank-3 ist die qualitätsorientierte Rerank-3-Ausgabe zur Bewertung der Relevanz von Anfrage-Dokument-Paaren. Sie ordnet abgerufene Textkandidaten neu, unterstützt natürlichsprachliche Relevanzanweisungen und verarbeitet Paare mit 32.000 Token für die Suche in langen Dokumenten, Code und Wissensbasen.

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
FeldTypAnforderungWerte und LimitsStandard
FelddocumentsTyparrayAnforderungErforderlichWerte und LimitsStandard—
FeldmodelTypstringAnforderungErforderlichWerte und Limits
voyageai/rerank-3
Standard—
FeldproviderTypschemaAnforderungOptionalWerte und LimitsStandard—
FeldqueryTypstringAnforderungErforderlichWerte und LimitsStandard—
Feldsession_idTypstringAnforderungOptionalWerte und LimitsStandard—
Feldtop_nTypintegerAnforderungOptionalWerte und Limits
Minimum: 1
Standard—
FeldtraceTypschemaAnforderungOptionalWerte und LimitsStandard—
FelduserTypstringAnforderungOptionalWerte und LimitsStandard—
Felddocuments[].textTypstringAnforderungOptionalWerte und LimitsStandard—
Felddocuments[].imageTypstringAnforderungOptionalWerte und LimitsStandard—
Kombinationen von Eingabematerialien

text_rerank · Erforderlich: query, documents array with minItems1

Methodenparameter und Lebenszyklus
ParameterVertrag
Parametercontent_typeVertragapplication/json
ParameterrequiredVertragmodel, query, documents
Parametermaterial_typesVertragtext
Parameteroptional_controlsVertragprovider, session_id, top_n, trace, user
Parametermultimodal_input_bindingVertragnull

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.

KonfigurationTarifstaffelAbrechnungseinheitGebühr
KonfigurationBasistarife für TokensTarifstaffelGrundtarifAbrechnungseinheit—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
KonfigurationUltraTarifstaffel—Abrechnungseinheit/ 1K TokensGebü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 →

Beispielanfragen

Ailoot Ultra · Neusortierung

Beibehaltene offizielle Anfragestruktur; Beispiel zur DokumentationEigene reale Anfrageinhalte verwenden und das vollständige Ergebnis speichern
{
  "documents": [
    "Paris is the capital of France.",
    "Berlin is the capital of Germany."
  ],
  "model": "voyageai/rerank-3",
  "query": "What is the capital of France?",
  "top_n": 3
}
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-3'
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
FeldTyp
FeldmodelTypstring
FeldidTypstring
FeldproviderTypstring
Feldresults[].indexTypinteger
Feldresults[].relevance_scoreTypnumber
Feldresults[].document.textTypstring
Feldresults[].document.imageTypstring
Feldusage.search_unitsTypinteger
Feldusage.total_tokensTypinteger
Feldusage.costTypnumber
Fehler und nächste Schritte
AntwortBedingungNächster Schritt
Antwort400 · invalid_request_errorBedingungUngültiges Pflichtfeld, ungültige Darstellung oder ungültiger WertNächster SchrittKorrigieren Sie das angegebene Anfragefeld.

Aliasnamen

Modellaliasnamen

Ailoot Ultra voyageai/rerank-3

Aliasnamen für Methodenpfade

Verwenden Sie die oben angezeigten Methodenpfade.

Zugehörige Aufrufer-IDs

voyageai/rerank-3

FAQ · VoyageAI by MongoDB: rerank-3
Welche Eingaben und Ergebnisse sind verfügbar?

POST /v1/rerank · voyageai/rerank-3: text → rerank

Welche Felder verwendet die Anfrage?

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

Welche Grenzen gelten?

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

Weitere Details

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 · Modellpreise ansehen

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 · Offizielles Angebot und Lizenzvertrag