models

VoyageAI by MongoDB: rerank-3

Markdown · JSON

VoyageAI by MongoDB: rerank-3

Voyage rerank-3 is de kwaliteitsgerichte Rerank 3-editie voor het scoren van de relevantie tussen zoekvraag en document. Het herschikt opgehaalde tekstkandidaten, ondersteunt relevantie-instructies in natuurlijke taal en verwerkt paren van 32.000 tokens voor zoeken in lange documenten, code en kennisbanken.

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.

Voyage rerank-3 is een tekstreranker die de kwaliteit van opgehaald bewijsmateriaal moet verbeteren. Met een zoekvraag en een lijst kandidaatdocumenten onderzoekt het elk paar samen en geeft het de kandidaten geordend op relevantie terug. Embeddings en trefwoordzoeken kunnen eerst een grote verzameling tot een beheersbare shortlist beperken; rerank-3 past vervolgens een gedetailleerdere relevantiebeoordeling op die shortlist toe. De uitvoer is gescoord zoekbewijsmateriaal dat een toepassing kan tonen of aan een afzonderlijke antwoordgeneratiestap kan doorgeven.

Kwaliteitsgerichte Rerank 3 De maker positioneert rerank-3 als de op nauwkeurigheid gerichte editie en rerank-3-lite als de editie voor latentiegevoelig zoeken. De derde generatie werkt de basisarchitectuur en trainingsmix bij, met specifieke verbeteringen voor het ophalen uit lange documenten en broncode ten opzichte van de overeenkomstige 2.5-voorgangers. De producent evalueert het op technische documentatie, code, meertalig materiaal en andere documentdomeinen. Die resultaten ondersteunen de ophaalrol; selecteer de editie op basis van de vragen en kandidaatdocumenten die voor je eigen verzameling belangrijk zijn.

Lange documenten met voldoende context Een lange kandidaat kan nuttige context bevatten die ver voorbij de openingsalinea ligt. Lever een samenhangende sectie of een document met de titel en relevant omliggend materiaal aan, zodat het model kan beoordelen hoe de werkelijke vraag zich tot de inhoud verhoudt. Behoud bij zoeken in productbeleid de koppen en uitzonderingen rond de relevante passage. Als meerdere opgehaalde secties uit dezelfde bron komen, behoud dan hun document- en sectie-identifiers; de toepassing kan zo tonen waar het geselecteerde bewijsmateriaal vandaan komt.

De zoekvraag en elke kandidaat delen het contextvenster. De huidige gids van de maker specificeert 32.000 tokens voor dat paar, inclusief een zoekvraag van maximaal 8.000 tokens. Een zoekvraag van 3.000 tokens laat dus maximaal 29.000 tokens voor elk document over. Bereid de invoer zo voor dat de essentiële inhoud past, vooral wanneer een lange inleiding of herhaalde standaardtekst anders het venster zou vullen. De gedocumenteerde afkapoptie is standaard ingeschakeld en kan te lange zoekvragen of documenttekst vóór het scoren inkorten. Onderzoek wat behouden blijft wanneer de plaats van een passage van belang is.

Code en technische informatie ophalen Voor de ophaalfase van een programmeerassistent kunnen kandidaten functie-implementaties, API-documentatie of technische uitleg als tekst bevatten. Voeg de symbolen, signatures en context toe die nodig zijn om vergelijkbare kandidaten te onderscheiden. Een zoekvraag zoals “Vind de functie die paden normaliseert met behoud van een afsluitend scheidingsteken” geeft concreet gedrag om op te matchen. Voeg eventuele relevante taal-, platform- of versievoorwaarden toe. Onderzoek na de rangschikking de geselecteerde code en de afhankelijkheden voordat je die als context gebruikt; een relevantiescore bewijst niet dat een implementatie aan elke opgegeven vereiste voldoet.

Instructies bepalen relevantie Het model behoudt de mogelijkheid voor instructiegestuurd herschikken die in Rerank 2.5 werd ingevoerd. Plaats een beknopte instructie vóór of na de zoekvraag wanneer de gebruikersbedoeling verduidelijking vereist. Leg bij zoeken in onderzoeksdocumenten uit of de nadruk op de titel, een bepaalde methode of een toepassingsdomein ligt. Specificeer voor een interne catalogus of de aanvraag over installatie, probleemoplossing of compatibiliteit gaat. Houd die instructie in lijn met de vraag; extra voorkeuren die met de hoofdvraag botsen, kunnen veranderen wat de rangschikking probeert te optimaliseren.

Bereid kandidaatdocumenten en budgetten voor De invoer is een lijst tekststrings. Haal bruikbare tekst uit brondocumenten, behoud betekenisvolle sectiegrenzen en houd een geordende registratiekoppeling naast de lijst bij. De maker staat maximaal 1.000 documenten in één aanvraag toe. Hij specificeert ook een totaal invoerplafond van 600.000 tokens: zoekvraagtokens vermenigvuldigd met het aantal documenten, plus de som van alle documenttokens. Dit verschilt van de contextlimiet per paar. Overbodige zoekvraagtekst verminderen kan zowel de paarcapaciteit als het totale aanvraagbudget behouden.

Tel tokens voor het relevante model in plaats van aan te nemen dat een woord- of tekentelling een tokentelling is. Selecteer voor grote kandidaten samenhangende passages of deel het materiaal op volgens nuttige koppen en behoud daarbij informatie over de bovenliggende bron. Herschikken is het nuttigst wanneer de eerste zoekopdracht al aannemelijke kandidaten heeft gevonden: het kan een ontbrekende bron die nooit in de lijst kwam niet rangschikken.

Gerangschikte resultaten en verder gebruik Het resultaat bevat relevantiescores en indices die naar de oorspronkelijke invoerdocumenten verwijzen, gesorteerd op aflopende relevantie. De optie top_k beperkt het aantal teruggegeven gerangschikte resultaten; anders worden alle invoerkandidaten teruggegeven. De REST-interface van de maker laat ook toe de documenttekst op te nemen. Gebruik elke oorspronkelijke index om de titel, bronidentifier en eventuele metagegevens die je toepassing nodig heeft terug te vinden en toon vervolgens de geselecteerde items of neem de relevante tekst op in de bewijscontext van een antwoord.

Toets de bovenste resultaten aan de vraag en houd de bronidentiteit zichtbaar. Een hoge relatieve rang verifieert de feitelijke juistheid van een document niet en een shortlist met alleen slechte kandidaten heeft nog steeds een eerste item. Scheid relevantieselectie van de beslissing of het geselecteerde bewijsmateriaal volstaat om de gebruiker te antwoorden.

Editiemigratie De maker beschrijft rerank-3 als een rechtstreeks vervangbare opvolger van rerank-2.5, met dezelfde API-semantiek en scores die op de verdeling van de overeenkomstige voorganger zijn gekalibreerd. Die compatibiliteit ondersteunt het behoud van een bestaande ophaalfase en registratiekoppeling. Vergelijk betekenisvolle resultaatvolgordes en eventuele scoredrempels op het huidige corpus voordat je op de migratie vertrouwt. Houd rerank-3 en rerank-3-lite als afzonderlijke keuzes: gedeelde limieten en de mogelijkheid om instructies te volgen maken hun prioriteiten voor kwaliteit en latentie niet identiek.

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

voyageai/rerank-3

VoyageAI by MongoDB /voyageai/rerank-3

Aan de slag

Voyage rerank-3 is de kwaliteitsgerichte Rerank 3-editie voor het scoren van de relevantie tussen zoekvraag en document. Het herschikt opgehaalde tekstkandidaten, ondersteunt relevantie-instructies in natuurlijke taal en verwerkt paren van 32.000 tokens voor zoeken in lange documenten, code en kennisbanken.

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

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

Aliasnamen voor methodepaden

Gebruik de hierboven getoonde methodepaden.

Gerelateerde aanroeper-ID’s

voyageai/rerank-3

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

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

Welke velden gebruikt het verzoek?

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

Welke limieten gelden?

POST /v1/rerank · voyageai/rerank-3: 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