Source: https://ailoot.ai/models/es/voyageai-rerank-2-5/ Canonical: https://ailoot.ai/models/es/voyageai-rerank-2-5/ Language: es # VoyageAI by MongoDB: rerank-2.5 [Markdown](https://ailoot.ai/models/es/voyageai-rerank-2-5/index.md) · [JSON](https://ailoot.ai/models/es/voyageai-rerank-2-5/facts.json) ## [VoyageAI by MongoDB: rerank-2.5](https://ailoot.ai/models/es/voyageai-rerank-2-5/) rerank-2.5 reordena un conjunto proporcionado de candidatos de texto según su relevancia para una consulta e instrucciones opcionales en lenguaje natural. Es un reclasificador multilingüe orientado a la calidad, con un contexto de 32,000 tokens por consulta-documento y puntuaciones ordenadas vinculadas a los índices originales de los candidatos. - [**Ailoot Ultra · Reordenación por relevancia** `POST /v1/rerank` `voyageai/rerank-2.5`](https://ailoot.ai/models/es/voyageai-rerank-2-5/#method-0) 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 es el reclasificador de Voyage AI con seguimiento de instrucciones, diseñado para afinar un conjunto de candidatos de búsqueda. Examina conjuntamente la consulta y cada documento como codificador cruzado y devuelve después una ordenación por relevancia. La versión del fabricante destaca el control en lenguaje natural sobre lo que se considera pertinente, la recuperación multilingüe y un contexto consulta-documento más largo que el de la edición anterior rerank-2. #### Proporciona al modelo los candidatos que debe comparar La entrada es una consulta y una lista de documentos de texto candidatos. Pueden ser pasajes seleccionados mediante búsqueda por embeddings o una búsqueda léxica inicial. El reclasificador evalúa el texto proporcionado en lugar de crear embeddings del corpus, por lo que su trabajo práctico es afinar los candidatos que ya encontró la búsqueda inicial. Conserva el orden original de los candidatos y los identificadores de fuente al preparar esa lista. Los índices devueltos remiten a esas posiciones de entrada. Para una tarea de RAG, proporciona los pasajes que la etapa de respuesta podría utilizar realmente, incluido el título o las condiciones necesarios para interpretarlos. Un documento pertinente ausente del conjunto de candidatos enviado no puede aparecer como un resultado recién encontrado por la reclasificación. #### Especifica la noción de relevancia deseada Las instrucciones pueden añadirse después o antes de la consulta. La versión describe tres funciones útiles: destacar una parte concreta de un documento, preferir un tipo de fuente y desambiguar la consulta mediante contexto de la aplicación. Modifican la tarea de relevancia presentada al modelo. Para una búsqueda técnica, una instrucción ilustrativa es «Prioriza los pasajes que expliquen el fallo y el comportamiento de recuperación; las introducciones generales son secundarias». Para una colección de investigación, especifica si importan más el título, el método o el resultado. Para un término ambiguo, indica el ámbito temático de la búsqueda. Mantén compatibles la pregunta y la instrucción para que una no pida un tema amplio mientras la otra cambie silenciosamente la tarea. Estas preferencias orientan la puntuación de relevancia. Si la aplicación tiene requisitos estrictos de admisión —como versión de fuente, fecha o ámbito de acceso—, prepara por separado el conjunto de candidatos admisibles. La instrucción de relevancia del modelo y una restricción determinista de la colección cumplen propósitos diferentes. #### Salida clasificada y uso posterior del resultado Los resultados se ordenan por relevancia descendente e incluyen una puntuación de relevancia de coma flotante y el índice original del candidato en la entrada. La opción top-k selecciona cuántos primeros resultados deben devolverse; sin ella, la especificación del fabricante devuelve resultados para todos los candidatos enviados. Un ajuste opcional return-documents incluye el texto de origen correspondiente; en caso contrario, la respuesta contiene índices y puntuaciones. Utiliza la ordenación para seleccionar pasajes que mostrar o pasar a una etapa posterior de respuesta, manteniendo intacta su identidad de origen. Examina el texto real al evaluar la clasificación: la puntuación mide la relevancia para la consulta enviada, no es una respuesta generada ni una verificación de que las afirmaciones del documento sean correctas. Esto hace útil al modelo para afinar material de búsqueda técnico, jurídico, financiero, médico, conversacional y multilingüe sin convertir la clasificación en una conclusión especializada. #### Contexto, presupuesto total de tokens y truncamiento El límite documentado de consulta es de 8,000 tokens, incluidas las instrucciones situadas en la consulta. La consulta más cualquier documento candidato deben caber en 32,000 tokens, y la lista de documentos puede contener como máximo 1,000 elementos. La asignación total es de 600,000 tokens, contados como tokens de consulta multiplicados por el número de documentos, más todos los tokens de los documentos. Por tanto, una instrucción larga se cuenta de nuevo en cada par de consulta y documento candidato. La cantidad de resultados top-k no cambia el número de candidatos en ese cálculo de tokens de entrada. El truncamiento predeterminado acorta las consultas o los documentos demasiado largos para cumplir el límite de contexto; desactivarlo hace que una consulta o un par demasiado largos devuelvan un error. Prepara deliberadamente pasajes que contengan la respuesta y mantén las condiciones pertinentes dentro del texto que verá el modelo. Evalúa el orden refinado con preguntas e instrucciones representativas y pasa después los pasajes originales seleccionados a la siguiente etapa. **Ailoot Ultra · Reordenación por relevancia** `POST /v1/rerank` `voyageai/rerank-2.5` [`voyageai/rerank-2.5`](https://ailoot.ai/models/es/#m=voyageai%2Frerank-2.5&route=Ultra&caller=voyageai%2Frerank-2.5&fmt=rerank) VoyageAI by MongoDB /`voyageai/rerank-2.5` ### Primeros pasos rerank-2.5 reordena un conjunto proporcionado de candidatos de texto según su relevancia para una consulta e instrucciones opcionales en lenguaje natural. Es un reclasificador multilingüe orientado a la calidad, con un contexto de 32,000 tokens por consulta-documento y puntuaciones ordenadas vinculadas a los índices originales de los candidatos. 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 | | --- | --- | --- | --- | --- | | Campo`documents` | Tipo`array` | RequisitoObligatorio | Valores y límites | Predeterminado— | | Campo`model` | Tipo`string` | RequisitoObligatorio | Valores y límites voyageai/rerank-2.5 | Predeterminado— | | Campo`provider` | Tipo`schema` | RequisitoOpcional | Valores y límites | Predeterminado— | | Campo`query` | Tipo`string` | RequisitoObligatorio | Valores y límites | Predeterminado— | | Campo`session_id` | Tipo`string` | RequisitoOpcional | Valores y límites | Predeterminado— | | Campo`top_n` | Tipo`integer` | RequisitoOpcional | Valores y límites Mínimo: 1 | Predeterminado— | | Campo`trace` | Tipo`schema` | RequisitoOpcional | Valores y límites | Predeterminado— | | Campo`user` | Tipo`string` | RequisitoOpcional | Valores y límites | Predeterminado— | | Campo`documents[].text` | Tipo`string` | RequisitoOpcional | Valores y límites | Predeterminado— | | Campo`documents[].image` | Tipo`string` | 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ámetro`content_type` | Contratoapplication/json | | Parámetro`required` | Contratomodel, query, documents | | Parámetro`material_types` | Contratotext | | Parámetro`optional_controls` | Contratoprovider, session\_id, top\_n, trace, user | | Parámetro`multimodal_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.0001** / 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 →](https://ailoot.ai/docs/es/billing/reserve/) ### 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 ```json { "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 } ``` ```bash 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 ``` ### 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 | | --- | --- | | Campo`model` | Tipostring | | Campo`id` | Tipostring | | Campo`provider` | Tipostring | | Campo`results[].index` | Tipointeger | | Campo`results[].relevance_score` | Tiponumber | | Campo`results[].document.text` | Tipostring | | Campo`results[].document.image` | Tipostring | | Campo`usage.search_units` | Tipointeger | | Campo`usage.total_tokens` | Tipointeger | | Campo`usage.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`](https://ailoot.ai/models/es/#m=voyageai%2Frerank-2.5&route=Ultra&caller=voyageai%2Frerank-2.5&fmt=rerank) #### Alias de rutas de métodos Usa las rutas de método indicadas arriba. #### ID de modelo relacionados [`voyageai/rerank-2.5`](https://ailoot.ai/models/es/#m=voyageai%2Frerank-2.5&route=Ultra&caller=voyageai%2Frerank-2.5&fmt=rerank) FAQ · VoyageAI by MongoDB: rerank-2.5 ¿Qué entradas y resultados están disponibles? `POST /v1/rerank` · `voyageai/rerank-2.5`: `text` → `rerank` ¿Qué campos utiliza la solicitud? `POST /v1/rerank` · `voyageai/rerank-2.5`: `documents`, `model`, `provider`, `query`, `session_id`, `top_n`, `trace`, `user` ¿Qué límites se aplican? `POST /v1/rerank` · `voyageai/rerank-2.5`: `top_n.minimum`: `1` 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](https://ailoot.ai/docs/es/billing/subscriptions/) · [Consultar precios de modelos](https://ailoot.ai/models/es/) ## 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](mailto:support@ailoot.ai) · [Oferta y acuerdo de licencia](https://ailoot.ai/legal/offer?lang=es) ## Ailoot · La empresa y su cartera de proyectos Ailoot se apoya en la experiencia operativa acumulada, una amplia base de clientes, un servicio estable y el seguimiento continuo de KPI. La empresa y su cartera de proyectos: millones de clientes; ventas por miles de millones al mes. Ailoot aplica esa experiencia operativa al acceso por API a funciones de IA en productos de clientes, agentes, aplicaciones y automatizaciones.