modelos

VoyageAI by MongoDB: rerank-3-lite

Markdown · JSON

VoyageAI by MongoDB: rerank-3-lite

Voyage rerank-3-lite puntúa y reordena documentos de texto candidatos para una consulta, con énfasis en búsquedas de respuesta rápida. Admite instrucciones de relevancia y una ventana de 32,000 tokens por consulta-documento, por lo que resulta útil después de la recuperación vectorial o por palabras clave en flujos de búsqueda y RAG.

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.

Voyage rerank-3-lite es la edición centrada en latencia de la serie Rerank 3 de Voyage. Recibe una consulta de texto y documentos candidatos, evalúa conjuntamente cada par consulta-documento y devuelve puntuaciones de relevancia en orden de clasificación. Actúa como segunda etapa de búsqueda: un recuperador por embeddings o palabras clave encuentra los candidatos y después Lite afina su orden. El resultado es una clasificación para utilizar en búsquedas o en un flujo de generación aumentada por recuperación.

Qué cambia en Rerank 3 Lite El productor destaca una recuperación mejorada en documentos extensos y código frente a rerank-2.5-lite. Ambas ediciones de Rerank 3 conservan el seguimiento de instrucciones y la misma clase de contexto de 32K, mientras que Lite está diseñada para aplicaciones sensibles a la latencia. Esto la convierte en una candidata práctica para búsqueda interactiva en bases de conocimiento, recuperación de documentos de soporte y consultas de código cuando los usuarios necesitan resultados pertinentes con rapidez. Elígela según los requisitos de calidad y tiempo de respuesta de la colección real, en lugar de asumir que una edición más pequeña implica una ventana de contexto menor.

Orienta la relevancia mediante la consulta La consulta puede acompañarse de instrucciones en lenguaje natural que expliquen qué se considera pertinente. Mantén concisas y coherentes la pregunta y la preferencia de relevancia. Para una búsqueda de soporte de software, utiliza «Encuentra el procedimiento para restablecer un dispositivo; prioriza las instrucciones para la revisión de hardware indicada». Para un nombre de producto ambiguo, incluye la categoría del producto para que no predominen significados sin relación. Una preferencia en la consulta orienta la puntuación semántica; utiliza metadatos explícitos de la colección para seleccionar el producto, la versión del documento o el ámbito de acceso correctos antes de construir la lista de candidatos.

Prepara una lista reducida de candidatos de texto Los documentos de entrada son cadenas de texto. Extrae texto legible del material de origen y conserva los títulos, encabezados, identificadores y contexto circundante útiles. Mantén una correspondencia estable entre cada posición de entrada y el registro original. Para un artículo de resolución de problemas, incluye el síntoma y el procedimiento pertinente, no solo una frase aislada. Para búsqueda de código fuente, incluye la función y la información cercana necesaria para distinguirla de otras funciones con nombres similares. Elimina la navegación repetitiva o el texto genérico cuando desplacen el pasaje útil.

El reclasificador solo puede reordenar los documentos que recibe. Si la primera búsqueda nunca recupera el artículo pertinente, esta etapa no puede recuperar ese candidato ausente. Examina tanto la lista reducida como el orden final cuando un resultado parezca incorrecto. Cuando un documento extenso abarque muchos temas, separa secciones coherentes y conserva sus referencias al documento principal para poder seleccionar una sección pertinente sin perder su fuente.

Límites de contexto y petición La guía actual del fabricante especifica un máximo de 8,000 tokens para la consulta y un máximo combinado de 32,000 tokens para la consulta más cada documento individual. Permite hasta 1,000 documentos candidatos y un presupuesto total de petición de 600,000 tokens, calculado como los tokens de consulta multiplicados por el número de documentos, más todos los tokens de los documentos. Por tanto, una consulta larga consume espacio en cada par y contribuye repetidamente al presupuesto agregado. Cuenta el texto enviado con el tokenizador del modelo adecuado en lugar de tratar caracteres, palabras y tokens como intercambiables.

Por ejemplo, una consulta de 500 tokens con 100 documentos de 4,000 tokens cada uno supone 450,000 tokens de entrada según esa fórmula. Esto ilustra la planificación del presupuesto, no un tamaño recomendado de lista reducida ni un resultado medido de velocidad. La opción documentada de truncamiento está activada por defecto; el texto demasiado largo puede acortarse antes de puntuarse. Prepara deliberadamente las secciones importantes para que el truncamiento no elimine precisamente el pasaje que necesitas encontrar.

Lee y utiliza el resultado Los resultados se ordenan de mayor a menor puntuación de relevancia. Cada resultado identifica la posición original del documento en la entrada, lo que permite a la aplicación añadir su propio título, identificador de registro y fuente. El ajuste top_k controla cuántos candidatos clasificados se devuelven; si se omite, se devuelven todos los candidatos. La interfaz REST del fabricante también puede devolver el texto del documento. Conserva los identificadores originales junto con los resultados seleccionados al mostrar una página de búsqueda o pasar pruebas a una etapa de generación de respuestas.

Una puntuación de relevancia expresa cuánto se ajusta un candidato a la consulta; no establece que sus afirmaciones sean correctas. Compara los elementos mejor clasificados con la pregunta real del usuario, incluidas las exclusiones y las diferencias de versión de los documentos. Si todos los candidatos son irrelevantes, sigue existiendo un elemento en primer lugar. Decide cómo debe tratar tu aplicación ese caso utilizando consultas representativas de la colección.

Actualización y elección de edición El fabricante describe rerank-3-lite como una actualización de rerank-2.5-lite con semántica de API sin cambios y puntuaciones calibradas según la distribución del predecesor correspondiente. Conserva la correspondencia existente de registros y la etapa de recuperación y compara después el orden resultante con consultas significativas antes de confiar en un umbral de puntuación establecido. Utiliza Lite para una experiencia de búsqueda donde importe el tiempo de respuesta; utiliza la edición rerank-3 centrada en calidad como comparación cuando la relevancia de candidatos difíciles sea la prioridad principal.

Ailoot Ultra · Reordenación por relevancia POST /v1/rerank voyageai/rerank-3-lite

voyageai/rerank-3-lite

VoyageAI by MongoDB /voyageai/rerank-3-lite

Primeros pasos

Voyage rerank-3-lite puntúa y reordena documentos de texto candidatos para una consulta, con énfasis en búsquedas de respuesta rápida. Admite instrucciones de relevancia y una ventana de 32,000 tokens por consulta-documento, por lo que resulta útil después de la recuperación vectorial o por palabras clave en flujos de búsqueda y RAG.

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
CampoTipoRequisitoValores y límitesPredeterminado
CampodocumentsTipoarrayRequisitoObligatorioValores y límitesPredeterminado—
CampomodelTipostringRequisitoObligatorioValores y límites
voyageai/rerank-3-lite
Predeterminado—
CampoproviderTiposchemaRequisitoOpcionalValores y límitesPredeterminado—
CampoqueryTipostringRequisitoObligatorioValores y límitesPredeterminado—
Camposession_idTipostringRequisitoOpcionalValores y límitesPredeterminado—
Campotop_nTipointegerRequisitoOpcionalValores y límites
Mínimo: 1
Predeterminado—
CampotraceTiposchemaRequisitoOpcionalValores y límitesPredeterminado—
CampouserTipostringRequisitoOpcionalValores y límitesPredeterminado—
Campodocuments[].textTipostringRequisitoOpcionalValores y límitesPredeterminado—
Campodocuments[].imageTipostringRequisitoOpcionalValores y límitesPredeterminado—
Combinaciones de materiales de entrada

text_rerank · Obligatorio: query, documents array with minItems1

Parámetros del método y ciclo de vida
ParámetroContrato
Parámetrocontent_typeContratoapplication/json
ParámetrorequiredContratomodel, query, documents
Parámetromaterial_typesContratotext
Parámetrooptional_controlsContratoprovider, session_id, top_n, trace, user
Parámetromultimodal_input_bindingContratonull

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ónTabla de tarifasUnidad de facturaciónCargo
ConfiguraciónTarifas base por tokenTabla de tarifasTarifa baseUnidad 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ónUltraTabla de tarifas—Unidad de facturación/ 1K tokensCargo
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

Estructura oficial de solicitud conservada; ejemplo de documentaciónUsa el material real de tu solicitud y conserva el resultado completo
{
  "documents": [
    "Paris is the capital of France.",
    "Berlin is the capital of Germany."
  ],
  "model": "voyageai/rerank-3-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-3-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
CampoTipo
CampomodelTipostring
CampoidTipostring
CampoproviderTipostring
Camporesults[].indexTipointeger
Camporesults[].relevance_scoreTiponumber
Camporesults[].document.textTipostring
Camporesults[].document.imageTipostring
Campousage.search_unitsTipointeger
Campousage.total_tokensTipointeger
Campousage.costTiponumber
Errores y siguientes pasos
RespuestaCondiciónSiguiente paso
Respuesta400 · invalid_request_errorCondiciónCampo obligatorio, representación o valor no válidoSiguiente pasoCorrige el campo indicado de la solicitud.

Alias

Alias del modelo

Ailoot Ultra voyageai/rerank-3-lite

Alias de rutas de métodos

Usa las rutas de método indicadas arriba.

ID de modelo relacionados

voyageai/rerank-3-lite

FAQ · VoyageAI by MongoDB: rerank-3-lite
¿Qué entradas y resultados están disponibles?

POST /v1/rerank · voyageai/rerank-3-lite: text → rerank

¿Qué campos utiliza la solicitud?

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

¿Qué límites se aplican?

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

Más detalles

Conecta Ailoot a Claude Code, OpenCode, Hermes o tu aplicación.

La empresa y su cartera de proyectos

La empresa y su cartera de proyectos: millones de clientes; ventas por miles de millones al mes.

Compra tokens con descuento.

Ahorro por suscripción para trabajo habitual. Códigos promocionales: hasta el 50% al comprar tokens.

Suscripción
Elige un plan con descuento para tus peticiones habituales.
Código de hasta el 50%
Introduce el código al comprar. El precio se recalcula según la promoción vigente.
Gasto en el historial
Modelo, tokens e importe quedan guardados por cada petición.

Elegir suscripción · Consultar precios de modelos

Conecta la API al producto que vendes.

SaaS, aplicaciones y bots bajo la oferta y el acuerdo de licencia Ailoot. Solicita una licencia de reventa para redistribuir el acceso.

Aplicación comercial
Integra generación de texto, imágenes, vídeo y sonido en funciones de pago de tu servicio.
Licencia para revendedores
Envía descripción del proyecto y esquema de acceso. Solicita condiciones escritas de uso y reventa.
Documentos en la web
La oferta, el acuerdo de licencia y la política de datos están disponibles antes de conectar.

Solicitar licencia de reventa · Oferta y acuerdo de licencia