models

VoyageAI by MongoDB: rerank-3-lite

Markdown · JSON

VoyageAI by MongoDB: rerank-3-lite

Voyage rerank-3-lite оценивает и переупорядочивает текстовые документы-кандидаты по запросу с акцентом на быстрый отклик поиска. Модель поддерживает инструкции о релевантности и окно в 32 000 токенов для пары «запрос — документ», что полезно после векторного или ключевого поиска в поисковых и RAG-процессах.

О модели

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

Voyage rerank-3-lite — редакция серии Rerank 3 от Voyage с приоритетом низкой задержки. Она принимает текстовый запрос и документы-кандидаты, совместно оценивает каждую пару «запрос — документ» и возвращает оценки релевантности в ранжированном порядке. Модель работает на втором этапе поиска: поиск по эмбеддингам или ключевым словам находит кандидатов, а Lite уточняет их порядок. Результат — ранжирование для поиска или процесса генерации с дополнением найденными данными.

Что изменилось в Rerank 3 Lite Разработчик подчёркивает улучшение поиска по длинным документам и коду по сравнению с rerank-2.5-lite. Обе редакции Rerank 3 сохраняют следование инструкциям и один класс контекста 32K, а Lite предназначена для приложений, чувствительных к задержке. Поэтому её стоит рассмотреть для интерактивного поиска по базе знаний, документам поддержки и коду, где пользователям нужны релевантные результаты без долгого ожидания. Выбирайте модель по требованиям реальной коллекции к качеству и времени отклика, не предполагая, что меньшая редакция означает меньшее окно контекста.

Управляйте релевантностью через запрос Вместе с запросом можно передать инструкции на естественном языке, объясняющие, что считать релевантным. Формулируйте вопрос и предпочтения кратко и согласованно. Для поиска по поддержке программного обеспечения можно использовать: «Найди процедуру сброса устройства; отдавай приоритет инструкциям для указанной аппаратной ревизии». Для неоднозначного названия продукта укажите категорию, чтобы посторонние значения не преобладали. Предпочтение в запросе направляет семантическую оценку; для выбора нужного продукта, версии документа или области доступа используйте явные метаданные коллекции до формирования списка кандидатов.

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

Реранкер может переупорядочить только полученные документы. Если первый поиск не нашёл нужную статью, этот этап не восстановит отсутствующего кандидата. Когда результат выглядит неверным, изучите и исходный список, и итоговый порядок. Если длинный документ охватывает много тем, разделите его на связные разделы и сохраните ссылки на родительский документ, чтобы выбрать нужный раздел, не теряя его источник.

Контекст и ограничения запроса Текущее руководство разработчика указывает максимум 8000 токенов для запроса и суммарно 32 000 токенов для запроса вместе с каждым отдельным документом. Допускается до 1000 документов-кандидатов и общий бюджет запроса в 600 000 токенов, который рассчитывается как число токенов запроса, умноженное на число документов, плюс все токены документов. Поэтому длинный запрос занимает место в каждой паре и многократно учитывается в общем бюджете. Считайте переданный текст подходящим токенизатором модели, не считая символы, слова и токены взаимозаменяемыми.

Например, запрос на 500 токенов и 100 документов по 4000 токенов каждый дают по этой формуле 450 000 входных токенов. Это иллюстрация расчёта бюджета, а не рекомендуемый размер списка или измеренный результат скорости. Документированная опция усечения включена по умолчанию; слишком длинный текст может сокращаться до оценки. Намеренно подготавливайте важные разделы, чтобы усечение не удалило именно тот фрагмент, который нужно сопоставить.

Читайте и используйте результат Результаты отсортированы по убыванию оценки релевантности. Каждый результат указывает исходную входную позицию документа, позволяя приложению добавить собственное название, идентификатор записи и источник. Настройка top_k определяет число возвращаемых ранжированных кандидатов; без неё возвращаются все. REST-интерфейс разработчика также может вернуть текст документа. Сохраняйте исходные идентификаторы рядом с выбранными результатами при показе поисковой страницы или передаче доказательств на этап генерации ответа.

Оценка релевантности выражает соответствие кандидата запросу; она не устанавливает истинность содержащихся в нём утверждений. Сверяйте первые результаты с фактическим вопросом пользователя, включая исключения и различия версий документов. Даже если все кандидаты нерелевантны, первый результат всё равно существует. Определите реакцию приложения на такой случай с помощью типичных запросов коллекции.

Обновление и выбор редакции Разработчик описывает rerank-3-lite как обновление rerank-2.5-lite с неизменной семантикой API и оценками, откалиброванными под распределение соответствующего предшественника. Сохраните существующее соответствие записей и этап поиска, затем сравните итоговый порядок на значимых запросах, прежде чем полагаться на установленный порог оценки. Используйте Lite для поиска, где важно время отклика; сопоставьте её с ориентированной на качество rerank-3, если важнее релевантность сложных кандидатов.

Ailoot Ultra · Переранжирование POST /v1/rerank voyageai/rerank-3-lite

voyageai/rerank-3-lite

VoyageAI by MongoDB /voyageai/rerank-3-lite

Начало

Voyage rerank-3-lite оценивает и переупорядочивает текстовые документы-кандидаты по запросу с акцентом на быстрый отклик поиска. Модель поддерживает инструкции о релевантности и окно в 32 000 токенов для пары «запрос — документ», что полезно после векторного или ключевого поиска в поисковых и RAG-процессах.

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

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

Ailoot Ultra · Переранжирование POST /v1/rerank
Входные данные
text
Результат
rerank
Выходной формат
json
ПолеТипТребованиеЗначения и ограниченияПо умолчанию
ПолеdocumentsТипarrayТребованиеОбязательноЗначения и ограниченияПо умолчанию—
ПолеmodelТипstringТребованиеОбязательноЗначения и ограничения
voyageai/rerank-3-lite
По умолчанию—
ПолеproviderТипschemaТребованиеНеобязательноЗначения и ограниченияПо умолчанию—
ПолеqueryТипstringТребованиеОбязательноЗначения и ограниченияПо умолчанию—
Полеsession_idТипstringТребованиеНеобязательноЗначения и ограниченияПо умолчанию—
Полеtop_nТипintegerТребованиеНеобязательноЗначения и ограничения
Минимум: 1
По умолчанию—
ПолеtraceТипschemaТребованиеНеобязательноЗначения и ограниченияПо умолчанию—
ПолеuserТипstringТребованиеНеобязательноЗначения и ограниченияПо умолчанию—
Полеdocuments[].textТипstringТребованиеНеобязательноЗначения и ограниченияПо умолчанию—
Полеdocuments[].imageТипstringТребованиеНеобязательноЗначения и ограниченияПо умолчанию—
Сочетания входных материалов

text_rerank · Обязательно: query, documents array with minItems1

Параметры и жизненный цикл метода
ПараметрКонтракт
Параметрcontent_typeКонтрактapplication/json
ПараметрrequiredКонтрактmodel, query, documents
Параметрmaterial_typesКонтрактtext
Параметрoptional_controlsКонтрактprovider, session_id, top_n, trace, user
Параметрmultimodal_input_bindingКонтрактnull

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

Передайте точный ID модели и сохраните полный нативный ответ.

Тарифы

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

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

Ставки Ailoot

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

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

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

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

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

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

Сохранённая официальная структура запроса; пример из документацииИспользуйте свои реальные материалы запроса и сохраните полный результат
{
  "documents": [
    "Paris is the capital of France.",
    "Berlin is the capital of Germany."
  ],
  "model": "voyageai/rerank-3-lite",
  "query": "What is the capital of France?",
  "top_n": 3
}
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-3-lite'
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

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

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

json

Сохраняйте все готовые результаты

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

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

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

Сохраните исходную операцию и полный либо частичный ответ; не повторяйте POST.

Поля ответа
ПолеТип
ПолеmodelТипstring
ПолеidТипstring
ПолеproviderТипstring
Полеresults[].indexТипinteger
Полеresults[].relevance_scoreТипnumber
Полеresults[].document.textТипstring
Полеresults[].document.imageТипstring
Полеusage.search_unitsТипinteger
Полеusage.total_tokensТипinteger
Полеusage.costТипnumber
Ошибки и дальнейшие шаги
ОтветУсловиеСледующий шаг
Ответ400 · invalid_request_errorУсловиеНедопустимое обязательное поле, представление или значениеСледующий шагИсправьте указанное поле запроса.

Псевдонимы

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

Ailoot Ultra voyageai/rerank-3-lite

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

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

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

voyageai/rerank-3-lite

FAQ · VoyageAI by MongoDB: rerank-3-lite
Какие входные данные и результаты доступны?

POST /v1/rerank · voyageai/rerank-3-lite: text → rerank

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

POST /v1/rerank · voyageai/rerank-3-lite: documents, model, provider, query, session_id, top_n, trace, user

Какие ограничения действуют?

POST /v1/rerank · voyageai/rerank-3-lite: top_n.minimum: 1

Подробнее

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

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

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

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

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

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

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

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

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

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

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