Source: https://ailoot.ai/models/es-mx/bge-reranker-v2-m3/
Canonical: https://ailoot.ai/models/es-mx/bge-reranker-v2-m3/
Language: es-mx

# bge-reranker-v2-m3

[Markdown](https://ailoot.ai/models/es-mx/bge-reranker-v2-m3/index.md) · [JSON](https://ailoot.ai/models/es-mx/bge-reranker-v2-m3/facts.json)

## [bge-reranker-v2-m3](https://ailoot.ai/models/es-mx/bge-reranker-v2-m3/)

Cross-encoder multilingüe de BAAI para clasificar pasajes candidatos frente a una consulta. Lee conjuntamente cada pareja consulta–pasaje y devuelve una puntuación de relevancia, refinando una lista corta de búsqueda sin generar una respuesta ni crear embeddings de documentos.

- [**Ailoot Ultra · Reordenación por relevancia** `POST /v1/rerank` `bge-reranker-v2-m3`](https://ailoot.ai/models/es-mx/bge-reranker-v2-m3/#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.

BGE Reranker v2 M3 es un modelo multilingüe de relevancia construido sobre BGE-M3. Recibe juntos una consulta y un pasaje candidato y devuelve una puntuación de su relación. BAAI presenta esta edición como un reranker multilingüe eficiente, incluso para recuperación en chino e inglés, cuando una aplicación de búsqueda necesita refinar una lista existente de candidatos.

#### Relevancia a partir de una pareja consulta–pasaje

Un cross-encoder procesa ambos textos conjuntamente, permitiendo que sus contenidos interactúen antes de producir la puntuación de relevancia. Esto difiere de un modelo de embeddings, que codifica textos de forma independiente para comparación vectorial reutilizable. La salida del reranker es una puntuación escalar para una pareja concreta, no un vector de documento ni una respuesta escrita.

Usa el modelo después de que una búsqueda inicial haya seleccionado pasajes plausibles. Empareja la pregunta con cada candidato y ordena los candidatos según las puntuaciones resultantes. Esto enfoca la comparación más detallada en una lista corta manejable en lugar de pedir a un cross-encoder inspeccionar cada pasaje de una colección grande.

#### La edición v2 M3

El creador identifica BGE-M3 como modelo base e incluye la compatibilidad multilingüe como una característica principal. Dentro de su familia de rerankers v2, M3 es la opción multilingüe eficiente; las variantes basadas en Gemma y con selección de capas son modelos distintos con diferentes elecciones de implementación. El nombre M3 aquí no significa que el reranker devuelva los embeddings densos, dispersos y multivectoriales del modelo de embeddings original.

Esta distinción importa al elegir el resultado que requiere tu aplicación. Selecciona un modelo de embeddings para representar y buscar una colección de documentos. Selecciona este reranker cuando ya tengas texto candidato y necesites decidir qué pasaje es más pertinente para la consulta actual.

#### Prepara candidatos que puedan clasificarse de forma útil

Proporciona la pregunta real y el texto candidato completo necesario para interpretarla. Conserva encabezados o definiciones cercanas cuando determinen el significado de un pasaje. En el ejemplo publicado de Transformers, la consulta y el pasaje se tokenizan juntos con truncamiento y max\_length=512. Es un ajuste de ejemplo, no un límite de todo el modelo. Mantén la pregunta y la evidencia requerida dentro del presupuesto seleccionado para la pareja y comprueba qué elimina el truncamiento. Un resultado que mencione el mismo producto que una consulta todavía puede ser irrelevante si aborda la operación o condición equivocada; prepara ejemplos que distingan esos casos al evaluar la calidad de recuperación.

Para un asistente documental, conserva los identificadores de candidatos junto con su texto, puntúa las parejas pregunta–pasaje y pasa los pasajes originales seleccionados al paso de respuesta. El modelo de respuesta recibe así la evidencia en lugar de una puntuación de relevancia sin su fuente. Este es un flujo ilustrativo de recuperación; el reranker en sí no busca en una colección externa ni escribe la respuesta.

#### Lee y normaliza las puntuaciones

El fabricante devuelve puntuaciones de relevancia sin procesar; un valor más alto indica una coincidencia más cercana. Su normalización opcional documentada aplica una función sigmoide para colocar la puntuación entre 0 y 1. Una puntuación normalizada tiene un rango conveniente, pero esa transformación por sí sola no establece una probabilidad calibrada de que el candidato sea correcto.

Elige umbrales de clasificación o filtrado usando parejas consulta–pasaje representativas de tu carga de trabajo. Incluye pasajes que compartan palabras clave pero respondan otra pregunta, así como pasajes pertinentes con una redacción distinta. Esto vuelve significativo el umbral seleccionado para la colección en la que se busca.

Para un proyecto con Ailoot API, define qué debe contener el contexto final y cuántos candidatos se pueden examinar de forma eficiente. El resultado útil es un conjunto de evidencia mejor ordenado para el siguiente paso de la aplicación. Mantén la salida de relevancia de esta edición separada de los embeddings de documentos, la prosa generada y los controles de selección de capas documentados para otros rerankers.

**Ailoot Ultra · Reordenación por relevancia** `POST /v1/rerank` `bge-reranker-v2-m3`

[`bge-reranker-v2-m3`](https://ailoot.ai/models/es-mx/#m=bge-reranker-v2-m3&route=Ultra&caller=bge-reranker-v2-m3&fmt=rerank)

BAAI /`bge-reranker-v2-m3`

### Inicio

Cross-encoder multilingüe de BAAI para clasificar pasajes candidatos frente a una consulta. Lee conjuntamente cada pareja consulta–pasaje y devuelve una puntuación de relevancia, refinando una lista corta de búsqueda sin generar una respuesta ni crear embeddings 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`

| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
| --- | --- | --- | --- | --- |
| Campo`model` | Tipo`string` | RequisitoObligatorio | Valores y límites bge-reranker-v2-m3 | Predeterminado— |
| Campo`query` | Tipo`string` | RequisitoOpcional | Valores y límites | Predeterminado— |
| Campo`documents` | Tipo`array` | RequisitoObligatorio | Valores y límites | Predeterminado— |

Parámetros del método y ciclo de vida

| Parámetro | Contrato |
| --- | --- |
| Parámetro`content_type` | Contratoapplication/json |
| Parámetro`required` | Contratomodel, documents |
| Parámetro`material_types` | Contratotext |
| Parámetro`material_conditions` | ContratoDefine tu consulta real y un arreglo no vacío de documentos de texto originales. Los índices del resultado se refieren a ese arreglo original. |

Ciclo de vida: `synchronous_result_then_owned_library`

`GET /v1/media/assets/{asset_id}/content`

`GET /v1/media/assets`

`GET /v1/media/assets/{asset_id}`

### 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óntoken total | Tabla de tarifas— | Unidad de facturación/ 1K tokens | Cargo Entrada · token total **$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 →](https://ailoot.ai/docs/es-mx/billing/reserve/)

### Solicitudes de ejemplo

#### Ailoot Ultra · Reordenación por relevancia

Usa la entrada real y conserva el resultado completo

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_QUERY:?Set the actual documented input value}"
export AILOOT_QUERY
: "${AILOOT_DOCUMENTS_JSON:?Set the actual documented input value}"
export AILOOT_DOCUMENTS_JSON
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'bge-reranker-v2-m3', 'query': '${ACTUAL_QUERY}', 'documents': '${ACTUAL_DOCUMENTS}'}
request['query']=os.environ['AILOOT_QUERY']
request['documents']=json.loads(os.environ['AILOOT_DOCUMENTS_JSON'])
Path('request.json').write_text(json.dumps(request,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 response.bin
# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.
```

### Recibir y guardar resultados

#### Ailoot Ultra · Reordenación por relevancia

Resultado JSON nativo original completo con el modelo de respuesta configurado, los índices de los documentos originales, las puntuaciones de relevancia, las cadenas de documentos y el uso nativo de tokens. Conserva cada campo real de resultado y uso.

- `GET /v1/media/assets/{asset_id}/content`
- `GET /v1/media/assets`
- `GET /v1/media/assets/{asset_id}`

##### Conserva todos los resultados completados

Conserva todas las respuestas, archivos y partes de contenido completos recibidos.

Conserva la respuesta completa y los encabezados, todas las salidas reales, los identificadores originales devueltos y todos los campos de uso. Recupera la operación original sin volver a enviar la solicitud de creación.

##### Si es necesario revisar la respuesta original

Conserva el X-Client-Request-ID real y la respuesta completa. Consulta los recursos originales que te pertenecen y sus URL exactas de contenido firmadas; nunca vuelvas a enviar una creación incierta.

Campos de respuesta

| Campo | Tipo | Significado |
| --- | --- | --- |
| Campo`model` | Tipostring | SignificadoModelo exacto de respuesta requerido por el consumidor configurado de la fuente. |
| Campo`results[].index` | Tipointeger | SignificadoÍndice único del documento de entrada original. |
| Campo`results[].relevance_score` | Tiponumber | SignificadoPuntuación finita de relevancia. |
| Campo`results[].document` | Tipostring | SignificadoDocumento de texto original requerido por este consumidor de respuestas configurado. |
| Campo`usage.total_tokens` | Tipointeger | SignificadoCantidad nativa de tokens finita y no negativa requerida por la tarifa aceptada vigente. |

Errores y siguientes pasos

| Respuesta | Condición | Siguiente paso |
| --- | --- | --- |
| Respuesta400 · `invalid_request_error` | CondiciónEl cuerpo JSON o el ID canónico explícito del modelo no son válidos. | Siguiente pasoConserva la respuesta y corrige el campo indicado de la solicitud. |
| Respuesta401 · `authentication_error` | CondiciónLa clave API de Ailoot no es válida. | Siguiente pasoUsa tu clave API autorizada de Ailoot. |
| Respuesta403 · `permission_error` | CondiciónEl grupo de la clave no admite este método. | Siguiente pasoConserva los detalles del error devueltos. |
| Respuesta404 · `not_found_error` | CondiciónEl método seleccionado no tiene una ruta admitida. | Siguiente pasoConserva los detalles del error devueltos. |
| Respuesta422 · `price_unavailable` | CondiciónLa tarifa aceptada no puede obtener la cantidad de entrada o el límite que requiere. | Siguiente pasoConserva la respuesta; usa la representación de entrada que requiere la tarifa aceptada. |
| Respuesta503 · `` | CondiciónEl almacenamiento requerido, la ruta, el precio del método o la reserva de fondos no están disponibles. | Siguiente pasoConserva la respuesta original completa. Una reserva incierta no autoriza un reenvío. |
| Respuesta502 · `billing_requires_check` | CondiciónEl resultado original, el uso o la liquidación del cargo requieren verificación. | Siguiente pasoConserva el ID real de solicitud y la respuesta original. Consulta el registro existente que te pertenece; no vuelvas a enviar la creación. |

### Alias

#### Alias del modelo

**Ailoot Ultra** [`bge-reranker-v2-m3`](https://ailoot.ai/models/es-mx/#m=bge-reranker-v2-m3&route=Ultra&caller=bge-reranker-v2-m3&fmt=rerank)

#### Alias de rutas de métodos

Usa las rutas de método indicadas arriba.

#### ID de modelo relacionados

[`bge-reranker-v2-m3`](https://ailoot.ai/models/es-mx/#m=bge-reranker-v2-m3&route=Ultra&caller=bge-reranker-v2-m3&fmt=rerank)

FAQ · bge-reranker-v2-m3

¿Qué entradas y resultados están disponibles?

`POST /v1/rerank` · `bge-reranker-v2-m3`: `text` → `rerank`

¿Qué campos utiliza la solicitud?

`POST /v1/rerank` · `bge-reranker-v2-m3`: `model`, `query`, `documents`

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-mx/billing/subscriptions/) · [Consultar precios de modelos](https://ailoot.ai/models/es-mx/)

## 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-mx)

## 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.
