models

VoyageAI by MongoDB: rerank-2.5

Markdown · JSON

VoyageAI by MongoDB: rerank-2.5

rerank-2.5 réordonne un ensemble fourni de candidats textuels selon leur pertinence pour une requête et d’éventuelles consignes en langage naturel. C’est un modèle de reclassement multilingue axé sur la qualité, avec un contexte requête-document de 32 000 tokens et des scores classés liés aux indices d’origine des candidats.

À propos du modèle

Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous.

rerank-2.5 est le modèle de reclassement de Voyage AI suivant des consignes, conçu pour affiner un ensemble de candidats de recherche. Il examine conjointement la requête et chaque document comme un encodeur croisé, puis renvoie un classement de pertinence. La publication du concepteur met en avant le contrôle en langage naturel de ce qui compte comme pertinent, la récupération multilingue et un contexte requête-document plus long que celui de l’édition rerank-2 précédente.

Donnez au modèle les candidats à comparer

L’entrée est une requête et une liste de documents textuels candidats. Il peut s’agir de passages sélectionnés par recherche d’embeddings ou par une première recherche lexicale. Le modèle de reclassement évalue le texte fourni au lieu de créer des embeddings du corpus ; son rôle pratique est donc d’affiner les candidats déjà trouvés par la recherche initiale.

Conservez l’ordre d’origine des candidats et les identifiants de sources lorsque vous préparez cette liste. Les indices renvoyés font référence à ces positions d’entrée. Pour une tâche RAG, fournissez les passages que l’étape de réponse pourrait réellement utiliser, avec le titre ou les conditions nécessaires à leur interprétation. Un document pertinent absent de l’ensemble de candidats soumis ne peut pas apparaître comme un nouveau résultat trouvé par le reclassement.

Précisez la notion de pertinence souhaitée

Les consignes peuvent être ajoutées avant ou après la requête. La publication décrit trois rôles utiles : mettre l’accent sur une partie précise d’un document, privilégier un type de source et lever l’ambiguïté de la requête avec le contexte de l’application. Ces consignes modifient la tâche de pertinence présentée au modèle.

Pour une recherche technique, un exemple de consigne est « Privilégiez les passages qui expliquent le comportement en cas d’échec et de récupération ; les présentations introductives sont secondaires. » Pour une collection de recherche, précisez si le titre, la méthode ou le résultat compte le plus. Pour un terme ambigu, indiquez le domaine auquel la recherche se rapporte. Gardez la question et la consigne compatibles, afin que l’une ne demande pas un sujet large tandis que l’autre modifie discrètement la tâche.

Ces préférences guident la notation de pertinence. Si l’application a des exigences strictes d’éligibilité — comme la version de la source, sa date ou le périmètre d’accès — préparez séparément l’ensemble de candidats éligibles. La consigne de pertinence du modèle et une restriction déterministe de collection remplissent des objectifs différents.

Sortie classée et utilisation ultérieure du résultat

Les résultats sont classés par pertinence décroissante et comprennent un score de pertinence à virgule flottante et l’indice d’entrée d’origine du candidat. L’option top-k sélectionne le nombre de premiers résultats à renvoyer ; en son absence, la spécification du concepteur renvoie les résultats de tous les candidats soumis. Un paramètre facultatif return-documents inclut le texte source correspondant ; sinon, la réponse contient les indices et les scores.

Utilisez le classement pour sélectionner les passages à afficher ou à transmettre à une étape de réponse ultérieure, en conservant leur identité de source. Examinez le texte réel pour évaluer le classement : le score mesure la pertinence par rapport à la requête soumise, et ne constitue ni une réponse générée ni une vérification de l’exactitude des affirmations du document. Le modèle sert ainsi à affiner les contenus de recherche techniques, juridiques, financiers, médicaux, conversationnels et multilingues sans transformer le classement en conclusion de domaine.

Contexte, budget total de tokens et troncature

La limite documentée de requête est de 8 000 tokens, consignes placées dans la requête comprises. La requête et n’importe quel document candidat individuel doivent tenir dans 32 000 tokens, et la liste de documents peut contenir au plus 1 000 éléments. L’allocation totale est de 600 000 tokens, comptés comme les tokens de la requête multipliés par le nombre de documents, plus tous les tokens des documents. Une longue consigne est donc comptée plusieurs fois dans les paires candidates.

Le nombre de sorties top-k ne change pas le nombre de candidats de ce calcul de tokens d’entrée. La troncature par défaut raccourcit les requêtes ou documents trop longs pour respecter la limite de contexte ; la désactiver fait renvoyer une erreur pour une requête ou une paire trop longue. Préparez délibérément des passages contenant la réponse et gardez les conditions pertinentes dans le texte que le modèle verra. Évaluez l’ordre affiné sur des questions et consignes représentatives, puis transmettez les passages originaux sélectionnés à l’étape suivante.

Ailoot Ultra · Reclassement POST /v1/rerank voyageai/rerank-2.5

voyageai/rerank-2.5

VoyageAI by MongoDB /voyageai/rerank-2.5

Premiers pas

rerank-2.5 réordonne un ensemble fourni de candidats textuels selon leur pertinence pour une requête et d’éventuelles consignes en langage naturel. C’est un modèle de reclassement multilingue axé sur la qualité, avec un contexte requête-document de 32 000 tokens et des scores classés liés aux indices d’origine des candidats.

Entrées acceptées
Texte
Résultats
Résultats classés

Disponible dans Ailoot · entrées et méthodes

Ailoot Ultra · Reclassement POST /v1/rerank
Entrée
text
Sortie
rerank
Format de sortie
json
ChampTypeExigenceValeurs et limitesPar défaut
ChampdocumentsTypearrayExigenceObligatoireValeurs et limitesPar défaut—
ChampmodelTypestringExigenceObligatoireValeurs et limites
voyageai/rerank-2.5
Par défaut—
ChampproviderTypeschemaExigenceFacultatifValeurs et limitesPar défaut—
ChampqueryTypestringExigenceObligatoireValeurs et limitesPar défaut—
Champsession_idTypestringExigenceFacultatifValeurs et limitesPar défaut—
Champtop_nTypeintegerExigenceFacultatifValeurs et limites
Minimum: 1
Par défaut—
ChamptraceTypeschemaExigenceFacultatifValeurs et limitesPar défaut—
ChampuserTypestringExigenceFacultatifValeurs et limitesPar défaut—
Champdocuments[].textTypestringExigenceFacultatifValeurs et limitesPar défaut—
Champdocuments[].imageTypestringExigenceFacultatifValeurs et limitesPar défaut—
Combinaisons d’éléments d’entrée

text_rerank · Obligatoire : query, documents array with minItems1

Paramètres et cycle de vie de la méthode
ParamètreContrat
Paramètrecontent_typeContratapplication/json
ParamètrerequiredContratmodel, query, documents
Paramètrematerial_typesContrattext
Paramètreoptional_controlsContratprovider, session_id, top_n, trace, user
Paramètremultimodal_input_bindingContratnull

Cycle de vie : synchronous

Envoyez l’ID exact du modèle et conservez la réponse native complète.

Tarifs

Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.

Mode rapide
Non précisé Lorsque le mode rapide est sélectionné
Mode Flex
Non précisé Lorsque le mode flex est sélectionné
Effort de raisonnement maximal
Non précisé Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default)

Tarifs Ailoot

Prix par configuration

Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.

ConfigurationBarème tarifaireUnité de facturationCoût
ConfigurationTarifs de base des jetonsBarème tarifaireTarif de baseUnité de facturation—Coût
Entrée · Tokens en entrée — / 1K tokens
Sortie · Tokens en sortie — / 1K tokens
Entrée · Lecture du cache — / 1K tokens
Entrée · Écriture dans le cache — / 1K tokens
Entrée · Écriture dans le cache, 1 h — / 1K tokens
ConfigurationUltraBarème tarifaire—Unité de facturation/ 1K tokensCoût
Entrée $0.0001 / 1K tokens

Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →

Exemples de requêtes

Ailoot Ultra · Reclassement

Structure officielle de requête conservée ; exemple de documentationUtilisez les données réelles de votre requête et conservez le résultat complet
{
  "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

Recevoir et enregistrer les résultats

Ailoot Ultra · Reclassement

json

Conserver tous les résultats terminés

Conservez chaque réponse, fichier et partie de contenu renvoyés dans leur intégralité.

Chaque index de résultat réel, chaque relevance_score fini et chaque objet document d’origine sont conservés. Les index renvoient au tableau de documents d’origine. L’intégralité du JSON d’origine est stockée et renvoyée uniquement après le règlement.

Si la réponse d’origine doit être vérifiée

Conservez l’opération d’origine ainsi que la réponse complète ou partielle ; ne rejouez pas le POST.

Champs de la réponse
ChampType
ChampmodelTypestring
ChampidTypestring
ChampproviderTypestring
Champresults[].indexTypeinteger
Champresults[].relevance_scoreTypenumber
Champresults[].document.textTypestring
Champresults[].document.imageTypestring
Champusage.search_unitsTypeinteger
Champusage.total_tokensTypeinteger
Champusage.costTypenumber
Erreurs et étapes suivantes
RéponseConditionÉtape suivante
Réponse400 · invalid_request_errorConditionChamp obligatoire, représentation ou valeur invalideÉtape suivanteCorrigez le champ indiqué de la requête.

Alias

Alias du modèle

Ailoot Ultra voyageai/rerank-2.5

Alias des chemins de méthode

Utilisez les chemins de méthode indiqués ci-dessus.

ID d’appel associés

voyageai/rerank-2.5

FAQ · VoyageAI by MongoDB: rerank-2.5
Quelles entrées et quels résultats sont disponibles ?

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

Quels champs la requête utilise-t-elle ?

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

Quelles limites s’appliquent ?

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

Plus de détails

Connectez Ailoot à Claude Code, OpenCode, Hermes ou à votre application.

L’entreprise et son portefeuille de projets

L’entreprise et son portefeuille de projets : des millions de clients ; des ventes qui se chiffrent en milliards chaque mois.

Achetez des tokens à prix réduit.

Une remise d’abonnement pour le travail régulier. Des codes promo jusqu’à 50% sur l’achat de tokens.

Abonnement
Choisissez une offre à tarif réduit pour vos requêtes régulières.
Code promo jusqu’à 50%
Saisissez le code à l’achat. Le prix est recalculé selon la promotion en cours.
Dépenses dans l’historique
Modèle, tokens et montant sont enregistrés pour chaque requête.

Choisir un abonnement · Voir les prix des modèles

Connectez l’API au produit que vous vendez.

SaaS, applications et bots selon l’offre officielle et le contrat de licence Ailoot. Pour la revente, demandez une licence revendeur.

Application commerciale
Intégrez la génération de texte, d’images, de vidéo et de son aux fonctions payantes de votre service.
Licence revendeur
Envoyez la description du projet et le mode d’accès. Demandez des conditions écrites d’utilisation et de revente.
Documents sur le site
L’offre officielle, le contrat de licence et la politique de traitement des données sont accessibles avant connexion.

Demander une licence revendeur · Offre officielle et contrat de licence