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 для ранжирования отобранных фрагментов по запросу. Он совместно читает каждую пару «запрос — фрагмент» и возвращает оценку релевантности, уточняя короткий список результатов поиска без генерации ответа или эмбеддингов документов.
- Допустимые входные данные
- Текст
- Результаты
- Ранжированные результаты
Доступно в 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}/contentGET /v1/media/assetsGET /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 для вызова
FAQ · bge-reranker-v2-m3
- Какие входные данные и результаты доступны?
POST /v1/rerank·bge-reranker-v2-m3:text→rerank- Какие поля использует запрос?
POST /v1/rerank·bge-reranker-v2-m3:model,query,documents