VoyageAI by MongoDB: rerank-2.5-lite
rerank-2.5-lite est le modèle de reclassement de Voyage AI orienté vers la faible latence et le suivi d’instructions pour un ensemble fourni de textes candidats. Il conserve un contexte requête-document de 32 000 tokens et la prise en charge multilingue, et retourne une liste ordonnée de scores de pertinence et d’indices des documents d’origine.
À 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-lite est le membre léger de la version 2.5 des modèles de reclassement de Voyage AI. Le fabricant le décrit comme un modèle généraliste équilibrant latence et qualité de pertinence, avec le suivi de consignes en langage naturel et une prise en charge multilingue. Son entrée est une requête et des textes candidats ; sa sortie est un ordre affiné de ces candidats avec des scores de pertinence.
Une décision de pertinence légère au deuxième stade
Le modèle Lite traite conjointement chaque paire requête-document comme un encodeur croisé. Il peut suivre une recherche initiale par embeddings ou lexicale et affiner les passages sélectionnés par cette étape. Cela diffère de la préparation d’un index d’embeddings réutilisable : le modèle de reclassement examine ensemble la requête et le texte du document envoyés pour la décision de pertinence actuelle.
Pour une recherche d’aide interactive, envoyez les explications candidates susceptibles de répondre à la question de l’utilisateur. Conservez assez de chaque passage pour transmettre le comportement et ses conditions, et préservez l’association entre l’indice d’entrée et l’élément source. Un ensemble ciblé de candidats aide à rendre la tâche de reclassement claire tout en laissant les éléments récupérés exploitables pour l’affichage ou une réponse ultérieure.
Les consignes expriment les priorités de l’utilisateur
Comme rerank-2.5, Lite accepte des consignes en langage naturel avant ou après la requête. Les exemples du fabricant les utilisent pour mettre en avant des parties de documents, sélectionner un type de source privilégié ou ajouter du contexte à un mot ambigu. Une application peut fournir une préférence de pertinence permanente, ou la question actuelle peut en inclure une plus précise.
Une requête d’assistance illustrative peut demander quel passage explique une erreur, avec une consigne privilégiant les étapes de dépannage aux descriptions générales du produit. Une recherche documentaire peut demander le libellé d’origine d’une politique plutôt qu’une discussion de celle-ci. Décrivez les éléments attendus et gardez la consigne concise. Les consignes influencent les scores de pertinence ; préparez les restrictions strictes de version, de date ou d’autorisation lors de la sélection des candidats au lieu de considérer une préférence de pertinence comme un filtre garanti.
Lire le classement et retourner le passage source
La sortie est triée par pertinence décroissante. Chaque résultat comprend l’indice du document d’origine et un score à virgule flottante ; le réglage facultatif return-documents retourne aussi le texte d’entrée correspondant. L’option top-k détermine le nombre de premiers résultats retournés, tandis que son omission retourne le classement de tous les candidats envoyés.
Utilisez ces indices pour retrouver le passage source et son identifiant. Un candidat reclassé peut devenir un résultat de recherche ou un élément probant pour l’étape RAG suivante, mais la sortie est un classement du texte fourni plutôt qu’une réponse réécrite. Évaluez si les premiers passages satisfont à la question et à la consigne de pertinence, y compris dans les langues et types de documents réellement présents dans la collection.
Limites et budget pratique des candidats
L’édition 2.5 Lite a un maximum documenté de 8 000 tokens pour la requête et une limite de 32 000 tokens pour la requête et chaque document individuel. Elle est distincte de l’ancien modèle rerank-2-lite et de son contexte plus petit. Il est possible d’envoyer au plus 1 000 documents, et l’entrée totale est limitée à 600 000 tokens selon la formule : les tokens de la requête multipliés par le nombre de candidats, plus la somme des tokens des documents candidats.
Pour une utilisation sensible à la latence, la FAQ du fabricant recommande rerank-2.5-lite avec au maximum 200 000 tokens au total par requête. Il s’agit d’une recommandation pratique sous le maximum annoncé, et non d’une autre fenêtre par document. Une requête ou une consigne plus longue est comptée une fois pour chaque paire requête-document ; le nombre de candidats et la longueur de la requête influencent donc tous deux le total.
La troncature est activée par défaut et raccourcit les entrées requête/document trop longues pour les faire tenir ; sa désactivation retourne une erreur pour une requête ou une paire trop longue. Préparez délibérément des candidats compacts contenant la réponse afin que les éléments utiles ne restent pas au-delà d’une limite tronquée. Sélectionner moins de résultats de sortie avec top-k ne retire pas les autres candidats fournis du calcul des tokens. Examinez les passages sources retournés et affinez la préparation des entrées selon les questions réelles auxquelles l’interface de recherche doit répondre.
Ailoot Ultra · Reclassement POST /v1/rerank voyageai/rerank-2.5-lite
voyageai/rerank-2.5-litePremiers pas
rerank-2.5-lite est le modèle de reclassement de Voyage AI orienté vers la faible latence et le suivi d’instructions pour un ensemble fourni de textes candidats. Il conserve un contexte requête-document de 32 000 tokens et la prise en charge multilingue, et retourne une liste ordonnée de scores de pertinence et d’indices des documents d’origine.
- 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
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champdocuments | Typearray | ExigenceObligatoire | Valeurs et limites | Par défaut— |
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites voyageai/rerank-2.5-lite | Par défaut— |
Champprovider | Typeschema | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Champquery | Typestring | ExigenceObligatoire | Valeurs et limites | Par défaut— |
Champsession_id | Typestring | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Champtop_n | Typeinteger | ExigenceFacultatif | Valeurs et limites Minimum: 1 | Par défaut— |
Champtrace | Typeschema | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Champuser | Typestring | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Champdocuments[].text | Typestring | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Champdocuments[].image | Typestring | ExigenceFacultatif | Valeurs et limites | Par 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ètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, query, documents |
Paramètrematerial_types | Contrattext |
Paramètreoptional_controls | Contratprovider, session_id, top_n, trace, user |
Paramètremultimodal_input_binding | Contratnull |
Cycle de vie : synchronous
Envoyez l’identifiant 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.
| Configuration | Barème tarifaire | Unité de facturation | Coût |
|---|---|---|---|
| ConfigurationTarifs de base des jetons | Barème tarifaireTarif de base | Unité 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 |
| ConfigurationUltra | Barème tarifaire— | Unité de facturation/ 1K tokens | Coût Entrée $0.00004 / 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
{
"documents": [
"Paris is the capital of France.",
"Berlin is the capital of Germany."
],
"model": "voyageai/rerank-2.5-lite",
"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-lite'
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 indice réel de résultat, chaque relevance_score fini et chaque objet de document d’origine est conservé. Les indices correspondent au tableau de documents d’origine. L’intégralité du JSON d’origine est enregistrée et renvoyée uniquement après la facturation définitive.
Si la réponse d’origine doit être vérifiée
Conservez l’opération d’origine et la réponse complète ou partielle ; ne répétez pas le POST.
Champs de la réponse
| Champ | Type |
|---|---|
Champmodel | Typestring |
Champid | Typestring |
Champprovider | Typestring |
Champresults[].index | Typeinteger |
Champresults[].relevance_score | Typenumber |
Champresults[].document.text | Typestring |
Champresults[].document.image | Typestring |
Champusage.search_units | Typeinteger |
Champusage.total_tokens | Typeinteger |
Champusage.cost | Typenumber |
Erreurs et étapes suivantes
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse400 · invalid_request_error | ConditionChamp obligatoire, représentation ou valeur invalide | Étape suivanteCorrigez le champ indiqué dans la requête. |
Alias
Alias du modèle
Ailoot Ultra voyageai/rerank-2.5-lite
Alias des chemins de méthode
Utilisez les chemins de méthode indiqués ci-dessus.
ID d’appel associés
FAQ · VoyageAI by MongoDB: rerank-2.5-lite
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/rerank·voyageai/rerank-2.5-lite:text→rerank- Quels champs la requête utilise-t-elle ?
POST /v1/rerank·voyageai/rerank-2.5-lite:documents,model,provider,query,session_id,top_n,trace,user- Quelles limites s’appliquent ?
POST /v1/rerank·voyageai/rerank-2.5-lite:top_n.minimum:1