rerank-2.5 es el reclasificador con seguimiento de instrucciones de Voyage AI, diseñado para afinar un conjunto de candidatos de búsqueda. Examina conjuntamente la consulta y cada documento como codificador cruzado y después devuelve un orden de relevancia. La publicación del fabricante destaca el control en lenguaje natural sobre lo que se considera pertinente, la recuperación multilingüe y un contexto de consulta-documento más largo que el de la edición anterior rerank-2.
La entrada es una consulta y una lista de documentos candidatos de texto. Pueden ser pasajes seleccionados por búsqueda de embeddings o una búsqueda léxica de primera etapa. El reclasificador evalúa el texto proporcionado en lugar de crear embeddings del corpus, así que su trabajo práctico es afinar los candidatos que la búsqueda inicial ya encontró.
Conserva el orden original de los candidatos y los identificadores de fuentes al preparar esa lista. Los índices devueltos se refieren a esas posiciones de entrada. Para una tarea RAG, proporciona los pasajes que la etapa de respuesta podría usar realmente, incluido el título o las condiciones necesarias para interpretarlos. Un documento pertinente que no esté en el conjunto de candidatos enviado no puede aparecer como un resultado recién encontrado de la reclasificación.
Las instrucciones se pueden agregar antes o después de la consulta. La publicación describe tres funciones útiles: destacar una parte particular de un documento, preferir un tipo de fuente y desambiguar la consulta con contexto de la aplicación. Estas 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 comportamiento ante fallas y la recuperación; las descripciones introductorias son secundarias». Para una colección de investigación, especifica si importa más el título, el método o el resultado. Para un término ambiguo, indica el área temática de la búsqueda. Mantén compatibles la pregunta y la instrucción para que una no pida un tema amplio mientras la otra cambia silenciosamente la tarea.
Estas preferencias guían la puntuación de relevancia. Si la aplicación tiene requisitos estrictos de elegibilidad, como versión de fuente, fecha o alcance de acceso, prepara por separado el conjunto de candidatos elegibles. La instrucción de relevancia del modelo y una restricción determinista de la colección cumplen propósitos distintos.
Los resultados se ordenan por relevancia descendente e incluyen una puntuación de relevancia de punto flotante y el índice original de entrada del candidato. La opción top-k selecciona cuántos resultados iniciales devolver; 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; de lo contrario, la respuesta contiene índices y puntuaciones.
Usa el orden para seleccionar pasajes que se mostrarán o pasarán a una etapa posterior de respuesta, manteniendo intacta su identidad de fuente. Inspecciona 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 que el modelo sea útil para afinar material de búsqueda técnico, legal, financiero, médico, conversacional y multilingüe sin convertir la clasificación en una conclusión del ámbito.
El límite documentado de consulta es de 8,000 tokens, incluidas las instrucciones colocadas en la consulta. La consulta más cualquier documento candidato individual 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 documentos. Por lo tanto, una instrucción larga se cuenta repetidamente entre los pares candidatos.
La cantidad top-k de salida 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; deshabilitarlo hace que una consulta o par demasiado largo devuelva un error. Prepara deliberadamente pasajes que contengan la respuesta y mantén la condición pertinente dentro del texto que verá el modelo. Evalúa el orden refinado con preguntas e instrucciones representativas y después pasa los pasajes originales seleccionados a la siguiente etapa.
", "aboutText": "rerank-2.5 es el reclasificador con seguimiento de instrucciones de Voyage AI, diseñado para afinar un conjunto de candidatos de búsqueda. Examina conjuntamente la consulta y cada documento como codificador cruzado y después devuelve un orden de relevancia. La publicación del fabricante destaca el control en lenguaje natural sobre lo que se considera pertinente, la recuperación multilingüe y un contexto de consulta-documento más largo que el de la edición anterior rerank-2.\n\n### Dale al modelo los candidatos que debe comparar\n\nLa entrada es una consulta y una lista de documentos candidatos de texto. Pueden ser pasajes seleccionados por búsqueda de embeddings o una búsqueda léxica de primera etapa. El reclasificador evalúa el texto proporcionado en lugar de crear embeddings del corpus, así que su trabajo práctico es afinar los candidatos que la búsqueda inicial ya encontró.\n\nConserva el orden original de los candidatos y los identificadores de fuentes al preparar esa lista. Los índices devueltos se refieren a esas posiciones de entrada. Para una tarea RAG, proporciona los pasajes que la etapa de respuesta podría usar realmente, incluido el título o las condiciones necesarias para interpretarlos. Un documento pertinente que no esté en el conjunto de candidatos enviado no puede aparecer como un resultado recién encontrado de la reclasificación.\n\n### Especifica la noción de relevancia deseada\n\nLas instrucciones se pueden agregar antes o después de la consulta. La publicación describe tres funciones útiles: destacar una parte particular de un documento, preferir un tipo de fuente y desambiguar la consulta con contexto de la aplicación. Estas modifican la tarea de relevancia presentada al modelo.\n\nPara una búsqueda técnica, una instrucción ilustrativa es «Prioriza los pasajes que expliquen el comportamiento ante fallas y la recuperación; las descripciones introductorias son secundarias». Para una colección de investigación, especifica si importa más el título, el método o el resultado. Para un término ambiguo, indica el área temática de la búsqueda. Mantén compatibles la pregunta y la instrucción para que una no pida un tema amplio mientras la otra cambia silenciosamente la tarea.\n\nEstas preferencias guían la puntuación de relevancia. Si la aplicación tiene requisitos estrictos de elegibilidad, como versión de fuente, fecha o alcance de acceso, prepara por separado el conjunto de candidatos elegibles. La instrucción de relevancia del modelo y una restricción determinista de la colección cumplen propósitos distintos.\n\n### Salida clasificada y uso posterior del resultado\n\nLos resultados se ordenan por relevancia descendente e incluyen una puntuación de relevancia de punto flotante y el índice original de entrada del candidato. La opción top-k selecciona cuántos resultados iniciales devolver; 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; de lo contrario, la respuesta contiene índices y puntuaciones.\n\nUsa el orden para seleccionar pasajes que se mostrarán o pasarán a una etapa posterior de respuesta, manteniendo intacta su identidad de fuente. Inspecciona 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 que el modelo sea útil para afinar material de búsqueda técnico, legal, financiero, médico, conversacional y multilingüe sin convertir la clasificación en una conclusión del ámbito.\n\n### Contexto, presupuesto total de tokens y truncamiento\n\nEl límite documentado de consulta es de 8,000 tokens, incluidas las instrucciones colocadas en la consulta. La consulta más cualquier documento candidato individual 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 documentos. Por lo tanto, una instrucción larga se cuenta repetidamente entre los pares candidatos.\n\nLa cantidad top-k de salida 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; deshabilitarlo hace que una consulta o par demasiado largo devuelva un error. Prepara deliberadamente pasajes que contengan la respuesta y mantén la condición pertinente dentro del texto que verá el modelo. Evalúa el orden refinado con preguntas e instrucciones representativas y después pasa los pasajes originales seleccionados a la siguiente etapa.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "e24967301913cb42ac13aaa39ca4696c6401eeb3fa5bb7d9c0b7201a5eb21f92", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "es-mx", "methods": [ { "html": "voyageai/rerank-2.5rerank-2.5 reordena un conjunto proporcionado de candidatos de texto por su relevancia para una consulta y las instrucciones opcionales en lenguaje natural. Es un reclasificador multilingüe orientado a calidad, con un contexto de consulta-documento de 32,000 tokens y puntuaciones clasificadas vinculadas a los índices originales de candidatos.
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 con seguimiento de instrucciones de Voyage AI, diseñado para afinar un conjunto de candidatos de búsqueda. Examina conjuntamente la consulta y cada documento como codificador cruzado y después devuelve un orden de relevancia. La publicación del fabricante destaca el control en lenguaje natural sobre lo que se considera pertinente, la recuperación multilingüe y un contexto de consulta-documento más largo que el de la edición anterior rerank-2.
La entrada es una consulta y una lista de documentos candidatos de texto. Pueden ser pasajes seleccionados por búsqueda de embeddings o una búsqueda léxica de primera etapa. El reclasificador evalúa el texto proporcionado en lugar de crear embeddings del corpus, así que su trabajo práctico es afinar los candidatos que la búsqueda inicial ya encontró.
Conserva el orden original de los candidatos y los identificadores de fuentes al preparar esa lista. Los índices devueltos se refieren a esas posiciones de entrada. Para una tarea RAG, proporciona los pasajes que la etapa de respuesta podría usar realmente, incluido el título o las condiciones necesarias para interpretarlos. Un documento pertinente que no esté en el conjunto de candidatos enviado no puede aparecer como un resultado recién encontrado de la reclasificación.
Las instrucciones se pueden agregar antes o después de la consulta. La publicación describe tres funciones útiles: destacar una parte particular de un documento, preferir un tipo de fuente y desambiguar la consulta con contexto de la aplicación. Estas 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 comportamiento ante fallas y la recuperación; las descripciones introductorias son secundarias». Para una colección de investigación, especifica si importa más el título, el método o el resultado. Para un término ambiguo, indica el área temática de la búsqueda. Mantén compatibles la pregunta y la instrucción para que una no pida un tema amplio mientras la otra cambia silenciosamente la tarea.
Estas preferencias guían la puntuación de relevancia. Si la aplicación tiene requisitos estrictos de elegibilidad, como versión de fuente, fecha o alcance de acceso, prepara por separado el conjunto de candidatos elegibles. La instrucción de relevancia del modelo y una restricción determinista de la colección cumplen propósitos distintos.
Los resultados se ordenan por relevancia descendente e incluyen una puntuación de relevancia de punto flotante y el índice original de entrada del candidato. La opción top-k selecciona cuántos resultados iniciales devolver; 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; de lo contrario, la respuesta contiene índices y puntuaciones.
Usa el orden para seleccionar pasajes que se mostrarán o pasarán a una etapa posterior de respuesta, manteniendo intacta su identidad de fuente. Inspecciona 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 que el modelo sea útil para afinar material de búsqueda técnico, legal, financiero, médico, conversacional y multilingüe sin convertir la clasificación en una conclusión del ámbito.
El límite documentado de consulta es de 8,000 tokens, incluidas las instrucciones colocadas en la consulta. La consulta más cualquier documento candidato individual 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 documentos. Por lo tanto, una instrucción larga se cuenta repetidamente entre los pares candidatos.
La cantidad top-k de salida 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; deshabilitarlo hace que una consulta o par demasiado largo devuelva un error. Prepara deliberadamente pasajes que contengan la respuesta y mantén la condición pertinente dentro del texto que verá el modelo. Evalúa el orden refinado con preguntas e instrucciones representativas y después pasa los pasajes originales seleccionados a la siguiente etapa.
POST /v1/reranktextrerank| 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 | 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— |
text_rerank · Obligatorio: query, documents array with minItems1
| 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.
Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.
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 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 →
{\n "documents": [\n "Paris is the capital of France.",\n "Berlin is the capital of Germany."\n ],\n "model": "voyageai/rerank-2.5",\n "query": "What is the capital of France?",\n "top_n": 3\n}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"\nexport AILOOT_REQUEST_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))\nif not isinstance(p,dict): raise SystemExit('Request must be a JSON object')\np['model']='voyageai/rerank-2.5'\nPath('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/rerank \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nprint(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))\nPY_RESULT\njson
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.
Conserva la operación original y la respuesta completa o parcial; no repitas el POST.
| 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 |
| 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. |
Ailoot Ultra voyageai/rerank-2.5
Usa las rutas de método indicadas arriba.