models

VoyageAI by MongoDB: rerank-2.5

Markdown · JSON

VoyageAI by MongoDB: rerank-2.5

rerank-2.5 herschikt een aangeleverde verzameling tekstkandidaten op relevantie voor een zoekvraag en optionele instructies in natuurlijke taal. Het is een meertalige, kwaliteitsgerichte reranker met een context van 32.000 tokens voor zoekvraag en document en gerangschikte scores die aan de oorspronkelijke kandidaatindices gekoppeld zijn.

Over het model

Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.

rerank-2.5 is de instructievolgende reranker van Voyage AI, ontworpen om een verzameling zoekkandidaten te verfijnen. Het onderzoekt de zoekvraag en elk document samen als een cross-encoder en geeft vervolgens een relevantievolgorde terug. De release van de maker benadrukt sturing in natuurlijke taal van wat als relevant geldt, meertalige informatieophaling en een langere context voor zoekvraag en document dan de voorgaande editie rerank-2.

Geef het model de te vergelijken kandidaten

De invoer is een zoekvraag en een lijst kandidaat-tekstdocumenten. Dat kunnen passages zijn die door embeddingzoeken of een lexicale eerste zoekfase zijn geselecteerd. De reranker beoordeelt de aangeleverde tekst in plaats van corpusembeddings aan te maken, zodat zijn praktische taak bestaat uit het verfijnen van de kandidaten die de eerste zoekopdracht al vond.

Behoud de oorspronkelijke kandidaatvolgorde en bronidentifiers wanneer je die lijst voorbereidt. De teruggegeven indices verwijzen naar die invoerposities. Geef voor een RAG-taak de passages mee die de antwoordfase werkelijk zou kunnen gebruiken, inclusief de titel of voorwaarden die nodig zijn voor de interpretatie. Een relevant document dat in de ingediende kandidaatverzameling ontbreekt, kan niet als nieuw gevonden resultaat van herschikken verschijnen.

Specificeer de bedoelde betekenis van relevantie

Instructies kunnen vóór of na de zoekvraag worden geplaatst. De release beschrijft drie nuttige rollen: een bepaald documentdeel benadrukken, een brontype verkiezen en de zoekvraag met toepassingscontext verduidelijken. Die veranderen de relevantietaak die aan het model wordt voorgelegd.

Voor een technische zoekopdracht is een illustratieve instructie: “Geef voorrang aan passages die het fout- en herstelgedrag uitleggen; inleidende overzichten zijn ondergeschikt.” Specificeer voor een onderzoeksverzameling of de titel, methode of het resultaat het belangrijkst is. Vermeld bij een dubbelzinnige term over welk vakgebied de zoekopdracht gaat. Houd de vraag en de instructie verenigbaar, zodat de ene niet om een breed onderwerp vraagt terwijl de andere stilzwijgend de taak verandert.

Die voorkeuren sturen de relevantiescore. Als de toepassing strikte toelatingsvereisten heeft — zoals bronversie, datum of toegangsbereik — bereid de toegelaten kandidaatverzameling dan afzonderlijk voor. De relevantie-instructie van het model en een deterministische beperking van de verzameling dienen verschillende doelen.

Gerangschikte uitvoer en later gebruik van resultaten

Resultaten staan op aflopende relevantie en bevatten een relevantiescore als zwevendekommagetal en de oorspronkelijke invoerindex van de kandidaat. De optie top-k selecteert hoeveel hoogst gerangschikte resultaten worden teruggegeven; zonder die optie geeft de fabrikantspecificatie resultaten voor alle ingediende kandidaten terug. Een optionele instelling return-documents neemt de bijbehorende brontekst op; anders bevat het antwoord indices en scores.

Gebruik de volgorde om passages voor weergave of een latere antwoordfase te selecteren en behoud hun bronidentiteit. Onderzoek de werkelijke tekst bij het beoordelen van de rangschikking: de score meet relevantie voor de ingediende zoekvraag en is geen gegenereerd antwoord of verificatie dat de beweringen van het document correct zijn. Daardoor is het model bruikbaar voor het verfijnen van technisch, juridisch, financieel, medisch, gespreks- en meertalig zoekmateriaal zonder een rangschikking in een domeinconclusie te veranderen.

Context, totaal tokenbudget en afkappen

De gedocumenteerde zoekvraaglimiet bedraagt 8.000 tokens, inclusief instructies die in de zoekvraag zijn geplaatst. De zoekvraag plus elk afzonderlijk kandidaatdocument moet binnen 32.000 tokens passen en de documentenlijst mag maximaal 1.000 items bevatten. De totale toekenning bedraagt 600.000 tokens, geteld als zoekvraagtokens vermenigvuldigd met het aantal documenten, plus alle documenttokens. Een lange instructie wordt dus herhaaldelijk over de kandidaatparen geteld.

Het aantal uitvoerresultaten bij top-k verandert het aantal kandidaten in die invoertokenberekening niet. Standaard afkappen kort te lange zoekvragen of documenten in om aan de contextlimiet te voldoen; uitschakelen laat een te lange zoekvraag of een te lang paar een fout teruggeven. Bereid antwoorddragende passages bewust voor en houd de relevante voorwaarde binnen de tekst die het model zal zien. Evalueer de verfijnde volgorde op representatieve vragen en instructies en geef vervolgens de geselecteerde oorspronkelijke passages aan de volgende fase door.

Ailoot Ultra · Opnieuw rangschikken POST /v1/rerank voyageai/rerank-2.5

voyageai/rerank-2.5

VoyageAI by MongoDB /voyageai/rerank-2.5

Aan de slag

rerank-2.5 herschikt een aangeleverde verzameling tekstkandidaten op relevantie voor een zoekvraag en optionele instructies in natuurlijke taal. Het is een meertalige, kwaliteitsgerichte reranker met een context van 32.000 tokens voor zoekvraag en document en gerangschikte scores die aan de oorspronkelijke kandidaatindices gekoppeld zijn.

Toegestane invoer
Tekst
Resultaten
Resultaten op relevantie

Beschikbaar in Ailoot · invoer en methoden

Ailoot Ultra · Opnieuw rangschikken POST /v1/rerank
Invoer
text
Uitvoer
rerank
Uitvoerformaat
json
VeldTypeVereisteWaarden en limietenStandaard
VelddocumentsTypearrayVereisteVereistWaarden en limietenStandaard—
VeldmodelTypestringVereisteVereistWaarden en limieten
voyageai/rerank-2.5
Standaard—
VeldproviderTypeschemaVereisteOptioneelWaarden en limietenStandaard—
VeldqueryTypestringVereisteVereistWaarden en limietenStandaard—
Veldsession_idTypestringVereisteOptioneelWaarden en limietenStandaard—
Veldtop_nTypeintegerVereisteOptioneelWaarden en limieten
Minimum: 1
Standaard—
VeldtraceTypeschemaVereisteOptioneelWaarden en limietenStandaard—
VelduserTypestringVereisteOptioneelWaarden en limietenStandaard—
Velddocuments[].textTypestringVereisteOptioneelWaarden en limietenStandaard—
Velddocuments[].imageTypestringVereisteOptioneelWaarden en limietenStandaard—
Combinaties van invoermaterialen

text_rerank · Vereist: query, documents array with minItems1

Methodeparameters en levenscyclus
ParameterContract
Parametercontent_typeContractapplication/json
ParameterrequiredContractmodel, query, documents
Parametermaterial_typesContracttext
Parameteroptional_controlsContractprovider, session_id, top_n, trace, user
Parametermultimodal_input_bindingContractnull

Levenscyclus: synchronous

Verstuur de exacte model-ID en bewaar het volledige natieve antwoord.

Tarieven

Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.

Snelle modus
Niet opgegeven Wanneer de snelle modus geselecteerd is
Flex-modus
Niet opgegeven Wanneer de flex-modus geselecteerd is
Maximale redeneerinspanning
Niet opgegeven Wanneer voor maximale redeneerinspanning de default-aanpassing wordt gebruikt

Ailoot-tarieven

Prijzen per configuratie

Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.

ConfiguratieTariefstaffelRekeneenheidKosten
ConfiguratieBasistarieven voor tokensTariefstaffelBasistariefRekeneenheid—Kosten
Invoer · Invoertokens — / 1K tokens
Uitvoer · Uitvoertokens — / 1K tokens
Invoer · Cache lezen — / 1K tokens
Invoer · Cache schrijven — / 1K tokens
Invoer · Cache schrijven, 1 uur — / 1K tokens
ConfiguratieUltraTariefstaffel—Rekeneenheid/ 1K tokensKosten
Invoer $0.0001 / 1K tokens

Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →

Voorbeeldverzoeken

Ailoot Ultra · Opnieuw rangschikken

Bewaarde officiële aanvraagstructuur; documentatievoorbeeldGebruik je daadwerkelijke aanvraagmateriaal en bewaar het volledige resultaat
{
  "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
}
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

Resultaten ophalen en opslaan

Ailoot Ultra · Opnieuw rangschikken

json

Alle voltooide resultaten bewaren

Bewaar elk volledig teruggegeven antwoord, bestand en inhoudsonderdeel.

Elke werkelijke resultaatindex, eindige relevance_score en elk oorspronkelijk documentobject blijven behouden. De indexen verwijzen naar de oorspronkelijke documentarray. De volledige oorspronkelijke JSON wordt opgeslagen en pas na de afrekening teruggestuurd.

Als het oorspronkelijke antwoord moet worden gecontroleerd

Bewaar de oorspronkelijke operatie en het volledige of gedeeltelijke antwoord; voer POST niet opnieuw uit.

Antwoordvelden
VeldType
VeldmodelTypestring
VeldidTypestring
VeldproviderTypestring
Veldresults[].indexTypeinteger
Veldresults[].relevance_scoreTypenumber
Veldresults[].document.textTypestring
Veldresults[].document.imageTypestring
Veldusage.search_unitsTypeinteger
Veldusage.total_tokensTypeinteger
Veldusage.costTypenumber
Fouten en vervolgstappen
AntwoordVoorwaardeVolgende stap
Antwoord400 · invalid_request_errorVoorwaardeOngeldig verplicht veld, ongeldige weergave of ongeldige waardeVolgende stapCorrigeer het aangegeven aanvraagveld.

Aliasnamen

Modelaliasnamen

Ailoot Ultra voyageai/rerank-2.5

Aliasnamen voor methodepaden

Gebruik de hierboven getoonde methodepaden.

Gerelateerde aanroeper-ID’s

voyageai/rerank-2.5

FAQ · VoyageAI by MongoDB: rerank-2.5
Welke invoer en resultaten zijn beschikbaar?

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

Welke velden gebruikt het verzoek?

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

Welke limieten gelden?

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

Meer details

Verbind Ailoot met Claude Code, OpenCode, Hermes of je eigen applicatie.

Het bedrijf en zijn projectenportefeuille

Het bedrijf en zijn projectenportefeuille: miljoenen klanten; maandelijkse verkopen in de miljarden.

Koop tokens met korting.

Abonnementsvoordeel voor regelmatig gebruik. Promotiecodes geven tot 50% korting op tokens.

Abonnement
Kies een abonnement met korting voor je terugkerende verzoeken.
Promotiecode tot 50%
Vul de code bij aankoop in. De prijs wordt volgens de lopende actie herberekend.
Kosten in de geschiedenis
Model, tokens en bedrag worden per verzoek bewaard.

Kies een abonnement · Bekijk modelprijzen

Verbind de API met het product dat je verkoopt.

SaaS, apps en bots volgens de openbare aanbodvoorwaarden en licentieovereenkomst van Ailoot. Vraag voor doorverkoop een resellerlicentie aan.

Commerciële applicatie
Voeg tekst-, beeld-, video- en geluidsgeneratie aan betaalde functies van je service toe.
Resellerlicentie
Stuur een projectbeschrijving en toegangsschema. Vraag schriftelijke voorwaarden voor gebruik en doorverkoop.
Documenten op de site
Aanbodvoorwaarden, licentieovereenkomst en gegevensbeleid zijn vóór het verbinden beschikbaar.

Vraag een resellerlicentie aan · Aanbodvoorwaarden en licentieovereenkomst