rerank-2.5 ist Voyage AIs anweisungsbefolgender Reranker zur Verfeinerung einer Auswahl von Suchkandidaten. Er untersucht Anfrage und jedes Dokument gemeinsam als Cross-Encoder und gibt anschließend eine Relevanzreihenfolge zurück. Die Herstellerveröffentlichung betont natürlichsprachliche Steuerung dessen, was als relevant gilt, mehrsprachigen Abruf und einen längeren Anfrage-Dokument-Kontext als bei der vorherigen Ausgabe rerank-2.
Die Eingabe besteht aus einer Anfrage und einer Liste von Textdokumentkandidaten. Dies können durch Embedding-Suche oder eine lexikalische Suche der ersten Stufe ausgewählte Textstellen sein. Der Reranker bewertet den bereitgestellten Text, statt Korpus-Embeddings zu erstellen; seine praktische Aufgabe ist daher die Verfeinerung der Kandidaten, die die anfängliche Suche bereits gefunden hat.
Erhalten Sie bei der Vorbereitung dieser Liste die ursprüngliche Kandidatenreihenfolge und Quellenkennungen. Die zurückgegebenen Indizes verweisen auf diese Eingabepositionen. Stellen Sie für eine RAG-Aufgabe die Textstellen bereit, die die Antwortstufe tatsächlich verwenden könnte, einschließlich des Titels oder der zur Interpretation nötigen Bedingungen. Ein relevantes Dokument, das in der eingereichten Kandidatenauswahl fehlt, kann nicht als neu gefundenes Reranking-Ergebnis erscheinen.
Anweisungen können an die Anfrage angehängt oder ihr vorangestellt werden. Die Veröffentlichung beschreibt drei nützliche Rollen: einen bestimmten Dokumentteil hervorheben, einen Quellentyp bevorzugen und die Anfrage mit Anwendungskontext eindeutig machen. Diese verändern die dem Modell gestellte Relevanzaufgabe.
Für eine technische Suche lautet eine beispielhafte Anweisung: „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 vereinbar, damit nicht eine ein breites Thema verlangt, während die andere unbemerkt die Aufgabe verändert.
Diese Präferenzen steuern die Relevanzbewertung. Hat die Anwendung strikte Zulässigkeitsanforderungen – etwa Quellversion, Datum oder Zugriffsbereich –, bereiten Sie die zulässige Kandidatenauswahl separat vor. Die Relevanzanweisung des Modells und eine deterministische Sammlungsbeschränkung erfüllen unterschiedliche Zwecke.
Die Ergebnisse sind absteigend nach Relevanz geordnet und enthalten einen Gleitkomma-Relevanzwert sowie den ursprünglichen Eingabeindex des Kandidaten. Die Option top-k legt fest, wie viele führende Ergebnisse zurückgegeben werden; ohne sie gibt die Herstellerspezifikation Ergebnisse für alle eingereichten Kandidaten zurück. Eine optionale Einstellung return-documents fügt den entsprechenden Quelltext bei; 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 erhalten Sie deren Quellenidentität. Prüfen Sie bei der Bewertung der Rangfolge den tatsächlichen Text: Der Wert misst Relevanz zur eingereichten Anfrage, ist keine generierte Antwort und keine Verifizierung der Richtigkeit von Dokumentaussagen. Dadurch ist das Modell nützlich zur Verfeinerung technischer, rechtlicher, finanzieller, medizinischer, gesprächsbezogener und mehrsprachiger Suchmaterialien, ohne Rangbildung in eine fachliche Schlussfolgerung umzudeuten.
Die dokumentierte Anfragegrenze beträgt 8.000 Token einschließlich der in der Anfrage enthaltenen Anweisungen. Die Anfrage plus ein einzelnes Kandidatendokument muss innerhalb von 32.000 Token liegen, und 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 alle 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. Standardmäßige Kürzung verkürzt zu lange Anfragen oder Dokumente auf die Kontextgrenze; bei Deaktivierung gibt eine zu lange Anfrage oder ein zu langes Paar einen Fehler zurück. Bereiten Sie antworttragende Textstellen bewusst vor und halten Sie die relevante Bedingung innerhalb des Texts, den das Modell sehen wird. Bewerten Sie die verfeinerte Reihenfolge anhand repräsentativer Fragen und Anweisungen und übergeben Sie anschließend die ausgewählten ursprünglichen Textstellen an die nächste Stufe.
", "aboutText": "rerank-2.5 ist Voyage AIs anweisungsbefolgender Reranker zur Verfeinerung einer Auswahl von Suchkandidaten. Er untersucht Anfrage und jedes Dokument gemeinsam als Cross-Encoder und gibt anschließend eine Relevanzreihenfolge zurück. Die Herstellerveröffentlichung betont natürlichsprachliche Steuerung dessen, was als relevant gilt, mehrsprachigen Abruf und einen längeren Anfrage-Dokument-Kontext als bei der vorherigen Ausgabe rerank-2.\n\n### Dem Modell die zu vergleichenden Kandidaten geben\n\nDie Eingabe besteht aus einer Anfrage und einer Liste von Textdokumentkandidaten. Dies können durch Embedding-Suche oder eine lexikalische Suche der ersten Stufe ausgewählte Textstellen sein. Der Reranker bewertet den bereitgestellten Text, statt Korpus-Embeddings zu erstellen; seine praktische Aufgabe ist daher die Verfeinerung der Kandidaten, die die anfängliche Suche bereits gefunden hat.\n\nErhalten Sie bei der Vorbereitung dieser Liste die ursprüngliche Kandidatenreihenfolge und Quellenkennungen. Die zurückgegebenen Indizes verweisen auf diese Eingabepositionen. Stellen Sie für eine RAG-Aufgabe die Textstellen bereit, die die Antwortstufe tatsächlich verwenden könnte, einschließlich des Titels oder der zur Interpretation nötigen Bedingungen. Ein relevantes Dokument, das in der eingereichten Kandidatenauswahl fehlt, kann nicht als neu gefundenes Reranking-Ergebnis erscheinen.\n\n### Den gewünschten Relevanzbegriff vorgeben\n\nAnweisungen können an die Anfrage angehängt oder ihr vorangestellt werden. Die Veröffentlichung beschreibt drei nützliche Rollen: einen bestimmten Dokumentteil hervorheben, einen Quellentyp bevorzugen und die Anfrage mit Anwendungskontext eindeutig machen. Diese verändern die dem Modell gestellte Relevanzaufgabe.\n\nFür eine technische Suche lautet eine beispielhafte Anweisung: „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 vereinbar, damit nicht eine ein breites Thema verlangt, während die andere unbemerkt die Aufgabe verändert.\n\nDiese Präferenzen steuern die Relevanzbewertung. Hat die Anwendung strikte Zulässigkeitsanforderungen – etwa Quellversion, Datum oder Zugriffsbereich –, bereiten Sie die zulässige Kandidatenauswahl separat vor. Die Relevanzanweisung des Modells und eine deterministische Sammlungsbeschränkung erfüllen unterschiedliche Zwecke.\n\n### Eingeordnete Ausgabe und spätere Ergebnisnutzung\n\nDie Ergebnisse sind absteigend nach Relevanz geordnet und enthalten einen Gleitkomma-Relevanzwert sowie den ursprünglichen Eingabeindex des Kandidaten. Die Option top-k legt fest, wie viele führende Ergebnisse zurückgegeben werden; ohne sie gibt die Herstellerspezifikation Ergebnisse für alle eingereichten Kandidaten zurück. Eine optionale Einstellung return-documents fügt den entsprechenden Quelltext bei; andernfalls enthält die Antwort Indizes und Werte.\n\nVerwenden Sie die Reihenfolge zur Auswahl von Textstellen für die Anzeige oder eine spätere Antwortstufe und erhalten Sie deren Quellenidentität. Prüfen Sie bei der Bewertung der Rangfolge den tatsächlichen Text: Der Wert misst Relevanz zur eingereichten Anfrage, ist keine generierte Antwort und keine Verifizierung der Richtigkeit von Dokumentaussagen. Dadurch ist das Modell nützlich zur Verfeinerung technischer, rechtlicher, finanzieller, medizinischer, gesprächsbezogener und mehrsprachiger Suchmaterialien, ohne Rangbildung in eine fachliche Schlussfolgerung umzudeuten.\n\n### Kontext, gesamtes Tokenbudget und Kürzung\n\nDie dokumentierte Anfragegrenze beträgt 8.000 Token einschließlich der in der Anfrage enthaltenen Anweisungen. Die Anfrage plus ein einzelnes Kandidatendokument muss innerhalb von 32.000 Token liegen, und 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 alle Dokument-Token. Eine lange Anweisung wird daher über die Kandidatenpaare hinweg wiederholt gezählt.\n\nDie Ausgabeanzahl top-k verändert nicht die Zahl der Kandidaten in dieser Eingabe-Tokenberechnung. Standardmäßige Kürzung verkürzt zu lange Anfragen oder Dokumente auf die Kontextgrenze; bei Deaktivierung gibt eine zu lange Anfrage oder ein zu langes Paar einen Fehler zurück. Bereiten Sie antworttragende Textstellen bewusst vor und halten Sie die relevante Bedingung innerhalb des Texts, den das Modell sehen wird. Bewerten Sie die verfeinerte Reihenfolge anhand repräsentativer Fragen und Anweisungen und übergeben Sie anschließend die ausgewählten ursprünglichen Textstellen an die nächste Stufe.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "bb79637334babe2b35676d245247bc376350139dee38073c58dbd267a05dafd2", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "de", "methods": [ { "html": "voyageai/rerank-2.5rerank-2.5 ordnet eine bereitgestellte Auswahl von Textkandidaten nach ihrer Relevanz für eine Anfrage und optionale natürlichsprachliche Anweisungen neu. Es ist ein mehrsprachiger, qualitätsorientierter Reranker mit einem Anfrage-Dokument-Kontext von 32.000 Token und eingeordneten Werten, die mit den ursprünglichen Kandidatenindizes verknüpft sind.
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 Voyage AIs anweisungsbefolgender Reranker zur Verfeinerung einer Auswahl von Suchkandidaten. Er untersucht Anfrage und jedes Dokument gemeinsam als Cross-Encoder und gibt anschließend eine Relevanzreihenfolge zurück. Die Herstellerveröffentlichung betont natürlichsprachliche Steuerung dessen, was als relevant gilt, mehrsprachigen Abruf und einen längeren Anfrage-Dokument-Kontext als bei der vorherigen Ausgabe rerank-2.
Die Eingabe besteht aus einer Anfrage und einer Liste von Textdokumentkandidaten. Dies können durch Embedding-Suche oder eine lexikalische Suche der ersten Stufe ausgewählte Textstellen sein. Der Reranker bewertet den bereitgestellten Text, statt Korpus-Embeddings zu erstellen; seine praktische Aufgabe ist daher die Verfeinerung der Kandidaten, die die anfängliche Suche bereits gefunden hat.
Erhalten Sie bei der Vorbereitung dieser Liste die ursprüngliche Kandidatenreihenfolge und Quellenkennungen. Die zurückgegebenen Indizes verweisen auf diese Eingabepositionen. Stellen Sie für eine RAG-Aufgabe die Textstellen bereit, die die Antwortstufe tatsächlich verwenden könnte, einschließlich des Titels oder der zur Interpretation nötigen Bedingungen. Ein relevantes Dokument, das in der eingereichten Kandidatenauswahl fehlt, kann nicht als neu gefundenes Reranking-Ergebnis erscheinen.
Anweisungen können an die Anfrage angehängt oder ihr vorangestellt werden. Die Veröffentlichung beschreibt drei nützliche Rollen: einen bestimmten Dokumentteil hervorheben, einen Quellentyp bevorzugen und die Anfrage mit Anwendungskontext eindeutig machen. Diese verändern die dem Modell gestellte Relevanzaufgabe.
Für eine technische Suche lautet eine beispielhafte Anweisung: „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 vereinbar, damit nicht eine ein breites Thema verlangt, während die andere unbemerkt die Aufgabe verändert.
Diese Präferenzen steuern die Relevanzbewertung. Hat die Anwendung strikte Zulässigkeitsanforderungen – etwa Quellversion, Datum oder Zugriffsbereich –, bereiten Sie die zulässige Kandidatenauswahl separat vor. Die Relevanzanweisung des Modells und eine deterministische Sammlungsbeschränkung erfüllen unterschiedliche Zwecke.
Die Ergebnisse sind absteigend nach Relevanz geordnet und enthalten einen Gleitkomma-Relevanzwert sowie den ursprünglichen Eingabeindex des Kandidaten. Die Option top-k legt fest, wie viele führende Ergebnisse zurückgegeben werden; ohne sie gibt die Herstellerspezifikation Ergebnisse für alle eingereichten Kandidaten zurück. Eine optionale Einstellung return-documents fügt den entsprechenden Quelltext bei; 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 erhalten Sie deren Quellenidentität. Prüfen Sie bei der Bewertung der Rangfolge den tatsächlichen Text: Der Wert misst Relevanz zur eingereichten Anfrage, ist keine generierte Antwort und keine Verifizierung der Richtigkeit von Dokumentaussagen. Dadurch ist das Modell nützlich zur Verfeinerung technischer, rechtlicher, finanzieller, medizinischer, gesprächsbezogener und mehrsprachiger Suchmaterialien, ohne Rangbildung in eine fachliche Schlussfolgerung umzudeuten.
Die dokumentierte Anfragegrenze beträgt 8.000 Token einschließlich der in der Anfrage enthaltenen Anweisungen. Die Anfrage plus ein einzelnes Kandidatendokument muss innerhalb von 32.000 Token liegen, und 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 alle 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. Standardmäßige Kürzung verkürzt zu lange Anfragen oder Dokumente auf die Kontextgrenze; bei Deaktivierung gibt eine zu lange Anfrage oder ein zu langes Paar einen Fehler zurück. Bereiten Sie antworttragende Textstellen bewusst vor und halten Sie die relevante Bedingung innerhalb des Texts, den das Modell sehen wird. Bewerten Sie die verfeinerte Reihenfolge anhand repräsentativer Fragen und Anweisungen und übergeben Sie anschließend die ausgewählten ursprünglichen Textstellen an die nächste Stufe.
POST /v1/reranktextrerank| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Felddocuments | Typarray | AnforderungErforderlich | Werte und Limits | Standard— |
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits voyageai/rerank-2.5 | Standard— |
Feldprovider | Typschema | AnforderungOptional | Werte und Limits | Standard— |
Feldquery | Typstring | AnforderungErforderlich | Werte und Limits | Standard— |
Feldsession_id | Typstring | AnforderungOptional | Werte und Limits | Standard— |
Feldtop_n | Typinteger | AnforderungOptional | Werte und Limits Minimum: 1 | Standard— |
Feldtrace | Typschema | AnforderungOptional | Werte und Limits | Standard— |
Felduser | Typstring | AnforderungOptional | Werte und Limits | Standard— |
Felddocuments[].text | Typstring | AnforderungOptional | Werte und Limits | Standard— |
Felddocuments[].image | Typstring | AnforderungOptional | Werte und Limits | Standard— |
text_rerank · Erforderlich: query, documents array with minItems1
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, query, documents |
Parametermaterial_types | Vertragtext |
Parameteroptional_controls | Vertragprovider, session_id, top_n, trace, user |
Parametermultimodal_input_binding | Vertragnull |
Lebenszyklus: synchronous
Senden Sie die genaue Modell-ID und bewahren Sie die vollständige native Antwort auf.
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
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 Token | TarifstaffelGrundtarif | Abrechnungseinheit— | Gebühr Eingabe · Eingabetoken — / 1K Token Ausgabe · Ausgabetoken — / 1K Token Eingabe · Cache-Lesen — / 1K Token Eingabe · Cache-Schreiben — / 1K Token Eingabe · Cache-Schreiben, 1 Stunde — / 1K Token |
| KonfigurationUltra | Tarifstaffel— | Abrechnungseinheit/ 1K Token | Gebühr Eingabe $0.0001 / 1K Token |
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 →
{\n "documents": [\n "Paris is the capital of France.",\n "Berlin is the capital of Germany."\n ],\n "model": "voyageai/rerank-2.5",\n "query": "What is the capital of France?",\n "top_n": 3\n}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"\nexport AILOOT_REQUEST_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))\nif not isinstance(p,dict): raise SystemExit('Request must be a JSON object')\np['model']='voyageai/rerank-2.5'\nPath('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/rerank \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nprint(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))\nPY_RESULT\njson
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 beziehen sich auf das ursprüngliche Dokumentarray. Das gesamte ursprüngliche JSON wird gespeichert und erst nach der Abrechnung zurückgegeben.
Bewahren Sie den ursprünglichen Vorgang sowie die vollständige oder teilweise Antwort auf; wiederholen Sie POST nicht.
| Feld | Typ |
|---|---|
Feldmodel | Typstring |
Feldid | Typstring |
Feldprovider | Typstring |
Feldresults[].index | Typinteger |
Feldresults[].relevance_score | Typnumber |
Feldresults[].document.text | Typstring |
Feldresults[].document.image | Typstring |
Feldusage.search_units | Typinteger |
Feldusage.total_tokens | Typinteger |
Feldusage.cost | Typnumber |
| 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. |
Ailoot Ultra voyageai/rerank-2.5
Verwenden Sie die oben angezeigten Methodenpfade.