rerank-2.5 is de instructievolgende reranker van Voyage AI, ontworpen om een reeks zoekkandidaten te verfijnen. Het onderzoekt de zoekvraag en elk document gezamenlijk als cross-encoder en geeft daarna een relevantievolgorde terug. De release van de maker benadrukt controle in natuurlijke taal over wat als relevant geldt, meertalige retrieval en een langere zoekvraag-documentcontext dan de voorgaande rerank-2-editie.
De invoer is een zoekvraag en een lijst kandidaattekstdocumenten. Dit kunnen passages zijn die door embeddingzoeken of een lexicale eerste zoekfase zijn geselecteerd. De reranker beoordeelt de aangeleverde tekst in plaats van corpusembeddings te maken, dus zijn praktische taak is de kandidaten te verfijnen die de eerste zoekopdracht al vond.
Behoud de oorspronkelijke kandidaatvolgorde en bronidentificatoren bij het voorbereiden van die lijst. De teruggegeven indices verwijzen naar die invoerposities. Lever voor een RAG-taak de passages aan die de antwoordfase daadwerkelijk zou kunnen gebruiken, inclusief de titel of voorwaarden die voor de interpretatie nodig zijn. Een relevant document dat ontbreekt in de ingediende kandidatenreeks kan niet als nieuw gevonden resultaat van reranking verschijnen.
Instructies kunnen vóór of achter de zoekvraag worden toegevoegd. De release beschrijft drie bruikbare rollen: een bepaald deel van een document benadrukken, een brontype verkiezen en de zoekvraag met toepassingscontext verduidelijken. Deze veranderen de relevantietaak die aan het model wordt voorgelegd.
Een illustratieve instructie voor technisch zoeken is: “Geef voorrang aan passages die het fout- en herstelgedrag uitleggen; inleidende overzichten zijn ondergeschikt.” Specificeer voor een onderzoekscollectie of titel, methode of resultaat het belangrijkst is. Vermeld voor een dubbelzinnige term het vakgebied waarop de zoekopdracht betrekking heeft. Houd vraag en instructie verenigbaar, zodat de ene niet om een breed onderwerp vraagt terwijl de andere de taak stilzwijgend verandert.
Deze voorkeuren sturen de relevantiescoring. Als de toepassing strikte toelatingseisen heeft — zoals bronversie, datum of toegangsafbakening — bereid dan de toegelaten kandidatenreeks afzonderlijk voor. De relevantie-instructie van het model en een deterministische collectiebeperking dienen verschillende doelen.
Resultaten worden op aflopende relevantie geordend en bevatten een relevantiescore als drijvendekommagetal en de oorspronkelijke invoerindex van de kandidaat. De optie top-k kiest hoeveel best gerangschikte resultaten moeten worden teruggegeven; zonder die optie geeft de specificatie van de fabrikant resultaten voor alle ingediende kandidaten terug. Een optionele instelling return-documents neemt de bijbehorende brontekst op; anders bevat de respons indices en scores.
Gebruik de volgorde om passages te selecteren voor weergave of een latere antwoordfase en houd hun bronidentiteit intact. Controleer de daadwerkelijke tekst bij het beoordelen van de rangschikking: de score is een maat voor de relevantie voor de ingediende zoekvraag, geen gegenereerd antwoord of verificatie dat de beweringen in het document juist zijn. Dit maakt het model nuttig voor het verfijnen van technisch, juridisch, financieel, medisch, conversationeel en meertalig zoekmateriaal zonder rangschikking om te zetten in een inhoudelijke domeinconclusie.
De gedocumenteerde zoekvraaglimiet is 8.000 tokens, inclusief instructies in de zoekvraag. De zoekvraag plus één kandidaatdocument moet binnen 32.000 tokens passen en de documentlijst mag maximaal 1.000 items bevatten. De totale ruimte is 600.000 tokens, geteld als zoekvraagtokens vermenigvuldigd met het aantal documenten, plus alle documenttokens. Een lange instructie wordt dus herhaaldelijk meegeteld over de kandidatenparen.
Het aantal uitvoerresultaten bij top-k verandert het aantal kandidaten in die invoertokenberekening niet. Standaard afkappen verkort te lange zoekvragen of documenten om aan de contextlimiet te voldoen; uitschakelen zorgt dat een te lange zoekvraag of een te lang paar een fout teruggeeft. Bereid antwoorddragende passages bewust voor en houd de relevante voorwaarden binnen de tekst die het model zal zien. Beoordeel de verfijnde volgorde op representatieve vragen en instructies en geef daarna de geselecteerde oorspronkelijke passages door aan de volgende fase.
", "aboutText": "rerank-2.5 is de instructievolgende reranker van Voyage AI, ontworpen om een reeks zoekkandidaten te verfijnen. Het onderzoekt de zoekvraag en elk document gezamenlijk als cross-encoder en geeft daarna een relevantievolgorde terug. De release van de maker benadrukt controle in natuurlijke taal over wat als relevant geldt, meertalige retrieval en een langere zoekvraag-documentcontext dan de voorgaande rerank-2-editie.\n\n### Geef het model de te vergelijken kandidaten\n\nDe invoer is een zoekvraag en een lijst kandidaattekstdocumenten. Dit kunnen passages zijn die door embeddingzoeken of een lexicale eerste zoekfase zijn geselecteerd. De reranker beoordeelt de aangeleverde tekst in plaats van corpusembeddings te maken, dus zijn praktische taak is de kandidaten te verfijnen die de eerste zoekopdracht al vond.\n\nBehoud de oorspronkelijke kandidaatvolgorde en bronidentificatoren bij het voorbereiden van die lijst. De teruggegeven indices verwijzen naar die invoerposities. Lever voor een RAG-taak de passages aan die de antwoordfase daadwerkelijk zou kunnen gebruiken, inclusief de titel of voorwaarden die voor de interpretatie nodig zijn. Een relevant document dat ontbreekt in de ingediende kandidatenreeks kan niet als nieuw gevonden resultaat van reranking verschijnen.\n\n### Specificeer de beoogde betekenis van relevantie\n\nInstructies kunnen vóór of achter de zoekvraag worden toegevoegd. De release beschrijft drie bruikbare rollen: een bepaald deel van een document benadrukken, een brontype verkiezen en de zoekvraag met toepassingscontext verduidelijken. Deze veranderen de relevantietaak die aan het model wordt voorgelegd.\n\nEen illustratieve instructie voor technisch zoeken is: “Geef voorrang aan passages die het fout- en herstelgedrag uitleggen; inleidende overzichten zijn ondergeschikt.” Specificeer voor een onderzoekscollectie of titel, methode of resultaat het belangrijkst is. Vermeld voor een dubbelzinnige term het vakgebied waarop de zoekopdracht betrekking heeft. Houd vraag en instructie verenigbaar, zodat de ene niet om een breed onderwerp vraagt terwijl de andere de taak stilzwijgend verandert.\n\nDeze voorkeuren sturen de relevantiescoring. Als de toepassing strikte toelatingseisen heeft — zoals bronversie, datum of toegangsafbakening — bereid dan de toegelaten kandidatenreeks afzonderlijk voor. De relevantie-instructie van het model en een deterministische collectiebeperking dienen verschillende doelen.\n\n### Gerangschikte uitvoer en later gebruik van resultaten\n\nResultaten worden op aflopende relevantie geordend en bevatten een relevantiescore als drijvendekommagetal en de oorspronkelijke invoerindex van de kandidaat. De optie top-k kiest hoeveel best gerangschikte resultaten moeten worden teruggegeven; zonder die optie geeft de specificatie van de fabrikant resultaten voor alle ingediende kandidaten terug. Een optionele instelling return-documents neemt de bijbehorende brontekst op; anders bevat de respons indices en scores.\n\nGebruik de volgorde om passages te selecteren voor weergave of een latere antwoordfase en houd hun bronidentiteit intact. Controleer de daadwerkelijke tekst bij het beoordelen van de rangschikking: de score is een maat voor de relevantie voor de ingediende zoekvraag, geen gegenereerd antwoord of verificatie dat de beweringen in het document juist zijn. Dit maakt het model nuttig voor het verfijnen van technisch, juridisch, financieel, medisch, conversationeel en meertalig zoekmateriaal zonder rangschikking om te zetten in een inhoudelijke domeinconclusie.\n\n### Context, totaal tokenbudget en afkappen\n\nDe gedocumenteerde zoekvraaglimiet is 8.000 tokens, inclusief instructies in de zoekvraag. De zoekvraag plus één kandidaatdocument moet binnen 32.000 tokens passen en de documentlijst mag maximaal 1.000 items bevatten. De totale ruimte is 600.000 tokens, geteld als zoekvraagtokens vermenigvuldigd met het aantal documenten, plus alle documenttokens. Een lange instructie wordt dus herhaaldelijk meegeteld over de kandidatenparen.\n\nHet aantal uitvoerresultaten bij top-k verandert het aantal kandidaten in die invoertokenberekening niet. Standaard afkappen verkort te lange zoekvragen of documenten om aan de contextlimiet te voldoen; uitschakelen zorgt dat een te lange zoekvraag of een te lang paar een fout teruggeeft. Bereid antwoorddragende passages bewust voor en houd de relevante voorwaarden binnen de tekst die het model zal zien. Beoordeel de verfijnde volgorde op representatieve vragen en instructies en geef daarna de geselecteerde oorspronkelijke passages door aan de volgende fase.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "1cdd4a3d7b88e73b98758a0c9a6eb06781c6590e56f07e06d6f41c659e053495", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "nl", "methods": [ { "html": "voyageai/rerank-2.5rerank-2.5 herschikt een aangeleverde reeks tekstkandidaten op relevantie voor een zoekvraag en optionele instructies in natuurlijke taal. Het is een meertalige, op kwaliteit gerichte reranker met een zoekvraag-documentcontext van 32.000 tokens en gerangschikte scores gekoppeld aan de oorspronkelijke kandidaatindices.
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 reeks zoekkandidaten te verfijnen. Het onderzoekt de zoekvraag en elk document gezamenlijk als cross-encoder en geeft daarna een relevantievolgorde terug. De release van de maker benadrukt controle in natuurlijke taal over wat als relevant geldt, meertalige retrieval en een langere zoekvraag-documentcontext dan de voorgaande rerank-2-editie.
De invoer is een zoekvraag en een lijst kandidaattekstdocumenten. Dit kunnen passages zijn die door embeddingzoeken of een lexicale eerste zoekfase zijn geselecteerd. De reranker beoordeelt de aangeleverde tekst in plaats van corpusembeddings te maken, dus zijn praktische taak is de kandidaten te verfijnen die de eerste zoekopdracht al vond.
Behoud de oorspronkelijke kandidaatvolgorde en bronidentificatoren bij het voorbereiden van die lijst. De teruggegeven indices verwijzen naar die invoerposities. Lever voor een RAG-taak de passages aan die de antwoordfase daadwerkelijk zou kunnen gebruiken, inclusief de titel of voorwaarden die voor de interpretatie nodig zijn. Een relevant document dat ontbreekt in de ingediende kandidatenreeks kan niet als nieuw gevonden resultaat van reranking verschijnen.
Instructies kunnen vóór of achter de zoekvraag worden toegevoegd. De release beschrijft drie bruikbare rollen: een bepaald deel van een document benadrukken, een brontype verkiezen en de zoekvraag met toepassingscontext verduidelijken. Deze veranderen de relevantietaak die aan het model wordt voorgelegd.
Een illustratieve instructie voor technisch zoeken is: “Geef voorrang aan passages die het fout- en herstelgedrag uitleggen; inleidende overzichten zijn ondergeschikt.” Specificeer voor een onderzoekscollectie of titel, methode of resultaat het belangrijkst is. Vermeld voor een dubbelzinnige term het vakgebied waarop de zoekopdracht betrekking heeft. Houd vraag en instructie verenigbaar, zodat de ene niet om een breed onderwerp vraagt terwijl de andere de taak stilzwijgend verandert.
Deze voorkeuren sturen de relevantiescoring. Als de toepassing strikte toelatingseisen heeft — zoals bronversie, datum of toegangsafbakening — bereid dan de toegelaten kandidatenreeks afzonderlijk voor. De relevantie-instructie van het model en een deterministische collectiebeperking dienen verschillende doelen.
Resultaten worden op aflopende relevantie geordend en bevatten een relevantiescore als drijvendekommagetal en de oorspronkelijke invoerindex van de kandidaat. De optie top-k kiest hoeveel best gerangschikte resultaten moeten worden teruggegeven; zonder die optie geeft de specificatie van de fabrikant resultaten voor alle ingediende kandidaten terug. Een optionele instelling return-documents neemt de bijbehorende brontekst op; anders bevat de respons indices en scores.
Gebruik de volgorde om passages te selecteren voor weergave of een latere antwoordfase en houd hun bronidentiteit intact. Controleer de daadwerkelijke tekst bij het beoordelen van de rangschikking: de score is een maat voor de relevantie voor de ingediende zoekvraag, geen gegenereerd antwoord of verificatie dat de beweringen in het document juist zijn. Dit maakt het model nuttig voor het verfijnen van technisch, juridisch, financieel, medisch, conversationeel en meertalig zoekmateriaal zonder rangschikking om te zetten in een inhoudelijke domeinconclusie.
De gedocumenteerde zoekvraaglimiet is 8.000 tokens, inclusief instructies in de zoekvraag. De zoekvraag plus één kandidaatdocument moet binnen 32.000 tokens passen en de documentlijst mag maximaal 1.000 items bevatten. De totale ruimte is 600.000 tokens, geteld als zoekvraagtokens vermenigvuldigd met het aantal documenten, plus alle documenttokens. Een lange instructie wordt dus herhaaldelijk meegeteld over de kandidatenparen.
Het aantal uitvoerresultaten bij top-k verandert het aantal kandidaten in die invoertokenberekening niet. Standaard afkappen verkort te lange zoekvragen of documenten om aan de contextlimiet te voldoen; uitschakelen zorgt dat een te lange zoekvraag of een te lang paar een fout teruggeeft. Bereid antwoorddragende passages bewust voor en houd de relevante voorwaarden binnen de tekst die het model zal zien. Beoordeel de verfijnde volgorde op representatieve vragen en instructies en geef daarna de geselecteerde oorspronkelijke passages door aan de volgende fase.
POST /v1/reranktextrerank| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Velddocuments | Typearray | VereisteVereist | Waarden en limieten | Standaard— |
Veldmodel | Typestring | VereisteVereist | Waarden en limieten voyageai/rerank-2.5 | Standaard— |
Veldprovider | Typeschema | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldquery | Typestring | VereisteVereist | Waarden en limieten | Standaard— |
Veldsession_id | Typestring | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldtop_n | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 | Standaard— |
Veldtrace | Typeschema | VereisteOptioneel | Waarden en limieten | Standaard— |
Velduser | Typestring | VereisteOptioneel | Waarden en limieten | Standaard— |
Velddocuments[].text | Typestring | VereisteOptioneel | Waarden en limieten | Standaard— |
Velddocuments[].image | Typestring | VereisteOptioneel | Waarden en limieten | Standaard— |
text_rerank · Vereist: query, documents array with minItems1
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, query, documents |
Parametermaterial_types | Contracttext |
Parameteroptional_controls | Contractprovider, session_id, top_n, trace, user |
Parametermultimodal_input_binding | Contractnull |
Levenscyclus: synchronous
Verstuur de exacte model-ID en bewaar het volledige native antwoord.
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Rekeneenheid | Kosten |
|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Rekeneenheid— | 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 |
| ConfiguratieUltra | Tariefstaffel— | Rekeneenheid/ 1K tokens | Kosten 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 →
{\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
Bewaar elk volledig teruggegeven antwoord, bestand en inhoudsonderdeel.
Elke daadwerkelijke resultaatindex, eindige relevance_score en elk oorspronkelijk documentobject blijven behouden. De indices koppelen aan de oorspronkelijke documentarray. De volledige oorspronkelijke JSON wordt opgeslagen en pas na afrekening geretourneerd.
Bewaar de oorspronkelijke operatie en het volledige of gedeeltelijke antwoord; herhaal POST niet.
| Veld | Type |
|---|---|
Veldmodel | Typestring |
Veldid | Typestring |
Veldprovider | Typestring |
Veldresults[].index | Typeinteger |
Veldresults[].relevance_score | Typenumber |
Veldresults[].document.text | Typestring |
Veldresults[].document.image | Typestring |
Veldusage.search_units | Typeinteger |
Veldusage.total_tokens | Typeinteger |
Veldusage.cost | Typenumber |
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeOngeldig vereist veld, ongeldige weergave of waarde | Volgende stapCorrigeer het aangegeven verzoekveld. |
Ailoot Ultra voyageai/rerank-2.5
Gebruik de hierboven getoonde methodepaden.