VoyageAI by MongoDB: rerank-2.5-lite
rerank-2.5-lite es el reclasificador de Voyage AI orientado a latencia y seguimiento de instrucciones para un conjunto proporcionado de candidatos de texto. Conserva un contexto de consulta-documento de 32,000 tokens y soporte multilingüe, y devuelve una lista ordenada de puntuaciones de relevancia e índices originales de documentos.
Sobre el modelo
Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado.
rerank-2.5-lite es el miembro ligero de la versión 2.5 de reclasificadores de Voyage AI. El fabricante lo describe como un modelo generalista que equilibra la latencia y la calidad de relevancia, con seguimiento de instrucciones en lenguaje natural y soporte multilingüe. Su entrada es una consulta y textos candidatos, y su salida es un orden refinado de esos candidatos con puntuaciones de relevancia.
Una decisión ligera de relevancia en la segunda etapa
El modelo Lite procesa conjuntamente cada par de consulta y documento como codificador cruzado. Puede seguir a una búsqueda de primera etapa basada en embeddings o léxica, afinando los pasajes seleccionados por esa etapa. Esto difiere de preparar un índice reutilizable de embeddings: el reclasificador examina juntos la consulta y el texto del documento enviados para la decisión de relevancia actual.
Para una búsqueda interactiva de ayuda, envía las explicaciones candidatas que podrían responder la pregunta del usuario. Conserva suficiente contenido de cada pasaje para comunicar el comportamiento y sus condiciones, y preserva la asociación entre el índice de entrada y el elemento de origen. Un conjunto de candidatos enfocado ayuda a aclarar la tarea de reclasificación y mantiene la evidencia recuperada utilizable para mostrarla o para una respuesta posterior.
Las instrucciones expresan lo que el usuario quiere priorizar
Al igual que rerank-2.5, Lite acepta instrucciones en lenguaje natural antes o después de la consulta. Los ejemplos del fabricante las usan para destacar componentes de documentos, seleccionar un tipo de fuente preferido o agregar contexto a una palabra ambigua. Una aplicación puede proporcionar una preferencia de relevancia permanente, o la pregunta actual puede incluir una más específica.
Una consulta ilustrativa de soporte puede preguntar qué pasaje explica un error, con una instrucción para priorizar pasos de solución de problemas sobre descripciones generales del producto. Una búsqueda documental puede pedir la redacción original de una política en lugar de un análisis de ella. Describe la evidencia deseada y mantén breve la instrucción. Las instrucciones influyen en las puntuaciones de relevancia; prepara cualquier restricción estricta de versión, fecha o permisos en la selección de candidatos, en lugar de tratar una preferencia de relevancia como un filtro garantizado.
Lee la clasificación y devuelve el pasaje de origen
La salida se ordena por relevancia decreciente. Cada resultado incluye el índice original del documento y una puntuación de punto flotante; el ajuste opcional return-documents también devuelve el texto de entrada correspondiente. La opción top-k determina cuántos resultados iniciales se devuelven, mientras que omitirla devuelve la clasificación de todos los candidatos enviados.
Usa esos índices para recuperar el pasaje de origen y su identificador. Un candidato reclasificado puede convertirse en resultado de búsqueda o evidencia para el siguiente paso RAG, pero la salida es un ordenamiento del texto proporcionado, no una respuesta reescrita. Evalúa si los primeros pasajes satisfacen tanto la pregunta como la instrucción de relevancia, incluidos los idiomas y tipos de documentos realmente presentes en la colección.
Límites y un presupuesto práctico de candidatos
La edición 2.5 Lite tiene un máximo documentado de consulta de 8,000 tokens y un límite de 32,000 tokens para la consulta más cada documento individual. Es distinta del modelo anterior rerank-2-lite y su contexto menor. Se pueden enviar como máximo 1,000 documentos y la entrada total se limita a 600,000 tokens según la fórmula: tokens de consulta multiplicados por la cantidad de candidatos, más la suma de tokens de los documentos candidatos.
Para usos sensibles a la latencia, las preguntas frecuentes del fabricante recomiendan rerank-2.5-lite con no más de 200,000 tokens totales por solicitud. Es una recomendación práctica por debajo del máximo indicado, no una ventana diferente por documento. Una consulta o instrucción más larga se cuenta una vez por cada par candidato, así que tanto la cantidad de candidatos como la longitud de la consulta afectan el total.
El truncamiento está habilitado por defecto y acorta la entrada de consulta o documento demasiado larga para que quepa; deshabilitarlo devuelve un error para una consulta o par que exceda la longitud. Prepara deliberadamente candidatos compactos que contengan la respuesta para que la evidencia útil no quede más allá de un límite truncado. Seleccionar menos resultados de salida mediante top-k no elimina los demás candidatos proporcionados del cálculo de tokens. Inspecciona los pasajes de origen devueltos y afina la preparación de entrada en torno a las preguntas reales que debe responder la interfaz de búsqueda.
Ailoot Ultra · Reordenación por relevancia POST /v1/rerank voyageai/rerank-2.5-lite
voyageai/rerank-2.5-liteInicio
rerank-2.5-lite es el reclasificador de Voyage AI orientado a latencia y seguimiento de instrucciones para un conjunto proporcionado de candidatos de texto. Conserva un contexto de consulta-documento de 32,000 tokens y soporte multilingüe, y devuelve una lista ordenada de puntuaciones de relevancia e índices originales de documentos.
- Entradas aceptadas
- Texto
- Resultados
- Resultados ordenados por relevancia
Disponible en Ailoot · entradas y métodos
Ailoot Ultra · Reordenación por relevancia POST /v1/rerank
- Entrada
text- Salida
rerank- Formato de salida
- json
| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campodocuments | Tipoarray | RequisitoObligatorio | Valores y límites | Predeterminado— |
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites voyageai/rerank-2.5-lite | Predeterminado— |
Campoprovider | Tiposchema | RequisitoOpcional | Valores y límites | Predeterminado— |
Campoquery | Tipostring | RequisitoObligatorio | Valores y límites | Predeterminado— |
Camposession_id | Tipostring | RequisitoOpcional | Valores y límites | Predeterminado— |
Campotop_n | Tipointeger | RequisitoOpcional | Valores y límites Mínimo: 1 | Predeterminado— |
Campotrace | Tiposchema | RequisitoOpcional | Valores y límites | Predeterminado— |
Campouser | Tipostring | RequisitoOpcional | Valores y límites | Predeterminado— |
Campodocuments[].text | Tipostring | RequisitoOpcional | Valores y límites | Predeterminado— |
Campodocuments[].image | Tipostring | RequisitoOpcional | Valores y límites | Predeterminado— |
Combinaciones de materiales de entrada
text_rerank · Obligatorio: query, documents array with minItems1
Parámetros del método y ciclo de vida
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratomodel, query, documents |
Parámetromaterial_types | Contratotext |
Parámetrooptional_controls | Contratoprovider, session_id, top_n, trace, user |
Parámetromultimodal_input_binding | Contratonull |
Ciclo de vida: synchronous
Envía el ID exacto del modelo y conserva la respuesta nativa completa.
Tarifas
Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.
- Modo fast
- Sin especificar Cuando se selecciona el modo fast
- Modo flex
- Sin especificar Cuando se selecciona el modo flex
- Esfuerzo máximo de razonamiento
- Sin especificar Cuando el esfuerzo máximo de razonamiento usa el ajuste default
Tarifas de Ailoot
Precios por configuración
Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.
| Configuración | Tabla de tarifas | Unidad de facturación | Cargo |
|---|---|---|---|
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Unidad de facturación— | Cargo Entrada · Tokens de entrada — / 1K tokens Salida · Tokens de salida — / 1K tokens Entrada · Lectura de caché — / 1K tokens Entrada · Escritura en caché — / 1K tokens Entrada · Escritura en caché, 1 hora — / 1K tokens |
| ConfiguraciónUltra | Tabla de tarifas— | Unidad de facturación/ 1K tokens | Cargo Entrada $0.00004 / 1K tokens |
Ailoot reserva un monto estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidación →
Solicitudes de ejemplo
Ailoot Ultra · Reordenación por relevancia
{
"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
Recibir y guardar resultados
Ailoot Ultra · Reordenación por relevancia
json
Conserva todos los resultados completados
Conserva todas las respuestas, archivos y partes de contenido completos recibidos.
Se conservan todos los índices reales del resultado, cada relevance_score finito y el objeto del documento original. Los índices vinculan el arreglo original de documentos. El JSON original completo se almacena y devuelve únicamente después de liquidar el cargo.
Si es necesario revisar la respuesta original
Conserva la operación original y la respuesta completa o parcial; no repitas el POST.
Campos de respuesta
| Campo | Tipo |
|---|---|
Campomodel | Tipostring |
Campoid | Tipostring |
Campoprovider | Tipostring |
Camporesults[].index | Tipointeger |
Camporesults[].relevance_score | Tiponumber |
Camporesults[].document.text | Tipostring |
Camporesults[].document.image | Tipostring |
Campousage.search_units | Tipointeger |
Campousage.total_tokens | Tipointeger |
Campousage.cost | Tiponumber |
Errores y siguientes pasos
| Respuesta | Condición | Siguiente paso |
|---|---|---|
Respuesta400 · invalid_request_error | CondiciónCampo obligatorio, representación o valor no válido | Siguiente pasoCorrige el campo indicado de la solicitud. |
Alias
Alias del modelo
Ailoot Ultra voyageai/rerank-2.5-lite
Alias de rutas de métodos
Usa las rutas de método indicadas arriba.
ID de modelo relacionados
FAQ · VoyageAI by MongoDB: rerank-2.5-lite
- ¿Qué entradas y resultados están disponibles?
POST /v1/rerank·voyageai/rerank-2.5-lite:text→rerank- ¿Qué campos utiliza la solicitud?
POST /v1/rerank·voyageai/rerank-2.5-lite:documents,model,provider,query,session_id,top_n,trace,user- ¿Qué límites se aplican?
POST /v1/rerank·voyageai/rerank-2.5-lite:top_n.minimum:1