models

bge-reranker-v2-m3

Markdown · JSON

bge-reranker-v2-m3

Многоязычный кросс-энкодер BAAI для ранжирования отобранных фрагментов по запросу. Он совместно читает каждую пару «запрос — фрагмент» и возвращает оценку релевантности, уточняя короткий список результатов поиска без генерации ответа или эмбеддингов документов.

О модели

Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.

BGE Reranker v2 M3 — многоязычная модель оценки релевантности на основе BGE-M3. Она совместно получает запрос и отобранный фрагмент и возвращает оценку их связи. BAAI позиционирует эту версию как эффективный многоязычный реранкер, в том числе для поиска на китайском и английском, когда поисковому приложению нужно уточнить уже имеющийся список кандидатов.

Релевантность пары «запрос — фрагмент»

Кросс-энкодер обрабатывает оба текста совместно, позволяя их содержимому взаимодействовать до формирования оценки релевантности. Это отличается от модели эмбеддингов, которая кодирует тексты независимо для многократного векторного сравнения. Результат реранкера — скалярная оценка конкретной пары, а не вектор документа или письменный ответ.

Используйте модель после первоначального поиска, отобравшего вероятно подходящие фрагменты. Соедините вопрос с каждым кандидатом и упорядочьте кандидатов по полученным оценкам. Так более подробное сравнение применяется к управляемому короткому списку, а не ко всем фрагментам большой коллекции.

Версия v2 M3

Разработчик указывает BGE-M3 как базовую модель и называет многоязычность одной из основных возможностей. В семействе реранкеров v2 M3 — эффективный многоязычный вариант; версии на основе Gemma и варианты с выбором слоёв являются отдельными моделями с другими особенностями реализации. Название M3 здесь не означает, что реранкер возвращает плотные, разреженные и многовекторные эмбеддинги исходной модели эмбеддингов.

Это различие важно при выборе нужного приложению результата. Выбирайте модель эмбеддингов для представления коллекции документов и поиска по ней. Выбирайте этот реранкер, когда тексты кандидатов уже есть и нужно определить, какой фрагмент наиболее релевантен текущему запросу.

Подготовка кандидатов для полезного ранжирования

Передайте реальный вопрос и весь текст кандидата, необходимый для его интерпретации. Сохраняйте заголовки или соседние определения, если они определяют смысл фрагмента. В опубликованном примере Transformers запрос и фрагмент токенизируются вместе с усечением и max_length=512. Это настройка примера, а не общий лимит модели. Размещайте вопрос и необходимые доказательства в выбранном бюджете пары и проверяйте, что удаляется при усечении. Результат, упоминающий тот же продукт, что и запрос, может оставаться нерелевантным, если описывает другую операцию или условие; при оценке качества поиска готовьте примеры, позволяющие различать такие случаи.

В помощнике по документам сохраняйте идентификаторы кандидатов вместе с их текстом, оценивайте пары «вопрос — фрагмент» и передавайте выбранные исходные фрагменты на этап ответа. Тогда отвечающая модель получает доказательства, а не оценку релевантности без источника. Это пример поискового процесса; сам реранкер не ищет во внешней коллекции и не пишет ответ.

Чтение и нормализация оценок

Производитель возвращает необработанные оценки релевантности: более высокое значение означает более близкое соответствие. Документированная необязательная нормализация применяет сигмоидную функцию, переводя оценку в диапазон от 0 до 1. Нормализованная оценка имеет удобный диапазон, но само это преобразование не устанавливает калиброванную вероятность правильности кандидата.

Выбирайте пороги ранжирования или фильтрации на репрезентативных парах «запрос — фрагмент» из своей нагрузки. Включайте фрагменты с общими ключевыми словами, отвечающие на другой вопрос, и релевантные фрагменты с иными формулировками. Тогда выбранный порог будет иметь смысл для коллекции, в которой выполняется поиск.

Для проекта с Ailoot API определите, что должен содержать итоговый контекст и сколько кандидатов можно эффективно проверить. Полезный результат — лучше упорядоченный набор доказательств для следующего шага приложения. Отделяйте оценки релевантности этой версии от эмбеддингов документов, сгенерированного текста и настроек выбора слоёв, документированных для других реранкеров.

Ailoot Ultra · Переранжирование POST /v1/rerank bge-reranker-v2-m3

bge-reranker-v2-m3

BAAI /bge-reranker-v2-m3

Начало

Многоязычный кросс-энкодер BAAI для ранжирования отобранных фрагментов по запросу. Он совместно читает каждую пару «запрос — фрагмент» и возвращает оценку релевантности, уточняя короткий список результатов поиска без генерации ответа или эмбеддингов документов.

Допустимые входные данные
Текст
Результаты
Ранжированные результаты

Доступно в Ailoot · входные данные и методы

Ailoot Ultra · Переранжирование POST /v1/rerank
Входные данные
text
Результат
rerank
ПолеТипТребованиеЗначения и ограниченияПо умолчанию
ПолеmodelТипstringТребованиеОбязательноЗначения и ограничения
bge-reranker-v2-m3
По умолчанию—
ПолеqueryТипstringТребованиеНеобязательноЗначения и ограниченияПо умолчанию—
ПолеdocumentsТипarrayТребованиеОбязательноЗначения и ограниченияПо умолчанию—
Параметры и жизненный цикл метода
ПараметрКонтракт
Параметрcontent_typeКонтрактapplication/json
ПараметрrequiredКонтрактmodel, documents
Параметрmaterial_typesКонтрактtext
Параметрmaterial_conditionsКонтрактУкажите реальный поисковый запрос и непустой массив исходных текстовых документов. Индексы результатов относятся к этому исходному массиву.

Жизненный цикл: synchronous_result_then_owned_library

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Тарифы

Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.

Быстрый режим
Не указано При выборе быстрого режима
Режим flex
Не указано При выборе режима flex
Максимальная интенсивность рассуждений
Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)

Ставки Ailoot

Цены по конфигурациям

Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.

КонфигурацияШкала ставокРасчётная единицаПлата
КонфигурацияБазовые тарифы на токеныШкала ставокБазовая ставкаРасчётная единица—Плата
Вход · Входные токены — / 1K токенов
Выход · Выходные токены — / 1K токенов
Вход · Чтение кэша — / 1K токенов
Вход · Запись в кэш — / 1K токенов
Вход · Запись в кэш, 1 час — / 1K токенов
Конфигурацияобщее число токеновШкала ставок—Расчётная единица/ 1K токеновПлата
Вход · общее число токенов $0.00004 / 1K токенов

Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →

Примеры запросов

Ailoot Ultra · Переранжирование

Используйте реальные входные данные и сохраните полный результат
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.

Получить и сохранить результаты

Ailoot Ultra · Переранжирование

Полный исходный нативный JSON-результат с настроенной моделью ответа, исходными индексами документов, оценками релевантности, строками документов и нативным использованием токенов. Сохраните каждый фактический результат и поле использования.

  • GET /v1/media/assets/{asset_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Сохраняйте все готовые результаты

Сохраняйте каждый полностью полученный ответ, файл и элемент содержимого.

Сохраняйте полный ответ и заголовки, все фактические результаты, исходные возвращённые идентификаторы и все поля использования. Восстанавливайте исходную операцию без повторной отправки запроса создания.

Если нужно проверить исходный ответ

Сохраните фактический X-Client-Request-ID и полный ответ. Читайте исходные ресурсы, принадлежащие Ailoot, по их точным подписанным URL содержимого; никогда не повторяйте создание с неопределённым исходом.

Поля ответа
ПолеТипЗначение
ПолеmodelТипstringЗначениеТочная модель ответа, требуемая настроенным обработчиком Source.
Полеresults[].indexТипintegerЗначениеУникальный индекс исходного входного документа.
Полеresults[].relevance_scoreТипnumberЗначениеКонечное значение оценки релевантности.
Полеresults[].documentТипstringЗначениеИсходный текстовый документ, требуемый этим настроенным обработчиком ответа.
Полеusage.total_tokensТипintegerЗначениеКонечное неотрицательное количество нативных токенов, требуемое текущим принятым тарифом.
Ошибки и дальнейшие шаги
ОтветУсловиеСледующий шаг
Ответ400 · invalid_request_errorУсловиеТело JSON или явно указанный канонический ID модели недопустимы.Следующий шагСохраните ответ и исправьте указанное поле запроса.
Ответ401 · authentication_errorУсловиеНедействительный ключ Ailoot API.Следующий шагИспользуйте ваш авторизованный ключ Ailoot API.
Ответ403 · permission_errorУсловиеГруппа ключа не допускает этот метод.Следующий шагСохраните возвращённые подробности ошибки.
Ответ404 · not_found_errorУсловиеУ выбранного метода нет допущенного маршрута.Следующий шагСохраните возвращённые подробности ошибки.
Ответ422 · price_unavailableУсловиеДля принятого тарифа невозможно определить требуемое количество входных данных или его границу.Следующий шагСохраните ответ; используйте представление входных данных, требуемое принятым тарифом.
Ответ503 · УсловиеТребуемое хранилище, маршрут, цена метода или резервирование недоступны.Следующий шагСохраните полный исходный ответ. Неопределённость резервирования не разрешает повторную отправку.
Ответ502 · billing_requires_checkУсловиеИсходный результат, использование или окончательный расчёт требуют проверки.Следующий шагСохраните фактический ID запроса и исходный ответ. Читайте существующую запись ресурса, принадлежащего Ailoot; не повторяйте создание.

Псевдонимы

Псевдонимы моделей

Ailoot Ultra bge-reranker-v2-m3

Псевдонимы путей метода

Используйте пути методов, указанные выше.

Связанные ID для вызова

bge-reranker-v2-m3

FAQ · bge-reranker-v2-m3
Какие входные данные и результаты доступны?

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

Какие поля использует запрос?

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

Подробнее

Подключите Ailoot к Claude Code, OpenCode, Hermes или своему приложению.

Компания и портфель её проектов

Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно.

Покупайте токены со скидкой.

Скидка по подписке для регулярной работы. Промокоды — до 50% на покупку токенов.

Подписка
Выберите тариф со скидкой для своих регулярных запросов.
Промокод до 50%
Введите код при покупке. Цена пересчитается с учётом действующей акции.
Расходы в истории
Модель, токены и сумма сохраняются для каждого запроса.

Выбрать подписку · Посмотреть цены моделей

Подключайте API к продукту, который вы продаёте.

SaaS, приложения и боты — по оферте и лицензионному договору Ailoot. Для перепродажи запросите реселлерскую лицензию.

Коммерческое приложение
Встраивайте генерацию текста, картинок, видео и звука в платные функции своего сервиса.
Лицензия для реселлера
Пришлите описание проекта и схему доступа. Запросите письменные условия использования и перепродажи.
Документы на сайте
Оферта, лицензионный договор и политика обработки данных доступны до подключения.

Запросить реселлерскую лицензию · Оферта и лицензионный договор