VoyageAI by MongoDB: rerank-2.5-lite
rerank-2.5-lite es el reclasificador de Voyage AI orientado a la latencia y al seguimiento de instrucciones para un conjunto proporcionado de candidatos de texto. Conserva un contexto de 32,000 tokens por consulta-documento 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 latencia y 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 segunda etapa
El modelo Lite procesa conjuntamente cada par consulta-documento como codificador cruzado. Puede seguir a una primera etapa de búsqueda por embeddings o léxica y afinar los pasajes seleccionados por esa etapa. Esto difiere de preparar un índice de embeddings reutilizable: el reclasificador examina juntos la consulta y el texto del documento enviados para la decisión actual de relevancia.
Para una búsqueda interactiva de ayuda, envía las explicaciones candidatas que podrían responder a la pregunta del usuario. Conserva suficiente contenido de cada pasaje para transmitir el comportamiento y sus condiciones, y preserva la asociación entre el índice de entrada y el elemento de origen. Un conjunto de candidatos concreto ayuda a dejar clara la tarea de reclasificación y mantiene las pruebas recuperadas utilizables para mostrarlas 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 utilizan para destacar componentes de documentos, seleccionar un tipo de fuente preferido o añadir contexto a una palabra ambigua. Una aplicación puede aportar una preferencia permanente de relevancia, o la pregunta actual puede incluir otra más específica.
Una consulta ilustrativa de soporte puede preguntar qué pasaje explica un error, con una instrucción para priorizar los pasos de resolución de problemas frente a descripciones generales del producto. Una búsqueda documental puede pedir la redacción original de una política en lugar de un comentario sobre ella. Describe las pruebas deseadas y mantén concisa la instrucción. Las instrucciones influyen en las puntuaciones de relevancia; prepara las restricciones estrictas de versión, fecha o permisos al seleccionar los 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 coma flotante; el ajuste opcional return-documents también devuelve el texto de entrada correspondiente. La opción top-k determina cuántos primeros resultados se devuelven, mientras que omitirla devuelve la clasificación de todos los candidatos enviados.
Utiliza esos índices para recuperar el pasaje de origen y su identificador. Un candidato reclasificado puede convertirse en un resultado de búsqueda o en pruebas para el siguiente paso de RAG, pero la salida es una ordenación 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 los 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 8,000 tokens por consulta y un límite de 32,000 tokens para la consulta más cada documento individual. Se diferencia del modelo anterior rerank-2-lite y de su contexto más pequeño. Pueden enviarse 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 el número de candidatos, más la suma de los 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 petición. Es una indicación práctica por debajo del máximo indicado, no una ventana por documento diferente. Una consulta o instrucción más larga se cuenta una vez por cada par de consulta y documento candidato, por lo que tanto el número de candidatos como la extensión de la consulta afectan al total.
El truncamiento está activado por defecto y acorta la entrada de consulta/documento demasiado larga para que quepa; al desactivarlo, una consulta o un par demasiado largos devuelven un error. Prepara deliberadamente candidatos compactos que contengan la respuesta para que las pruebas útiles no queden más allá del límite truncado. Seleccionar menos resultados de salida mediante top-k no elimina los otros candidatos proporcionados del cálculo de tokens. Examina los pasajes de origen devueltos y afina la preparación de la 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-litePrimeros pasos
rerank-2.5-lite es el reclasificador de Voyage AI orientado a la latencia y al seguimiento de instrucciones para un conjunto proporcionado de candidatos de texto. Conserva un contexto de 32,000 tokens por consulta-documento 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
- Tipos de entrada
text- Tipos de 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.
Planes
Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.
- Modo rápido
- Sin especificar Cuando se selecciona el modo rápido
- Modo flex
- Sin especificar Cuando se selecciona el modo flex
- Esfuerzo máximo de razonamiento
- Sin especificar Cuando el esfuerzo máximo de razonamiento utiliza el ajuste predeterminado (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 importe 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 conserva cada índice real de resultado, cada relevance_score finito y cada objeto de documento original. Los índices vinculan la lista original de documentos. El JSON original completo se almacena y solo se devuelve tras la liquidación.
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