Переранжирование (rerank) по API за рубли
Rerank по API: документы по порядку смысла вопроса, до 1 000 документов за запрос, top_n и оценки relevance_score. Цена в рублях, формат как у Cohere.
Обновлено:
Переранжирование (rerank) берёт вопрос и список документов и возвращает их по порядку: сначала самые подходящие по смыслу, с оценкой. Так уточняют результаты поиска: эмбеддинги или поиск по словам находят 50–100 кандидатов, rerank выбирает лучшие — и только они уходят в чат как контекст. Формат — как у rerank в Cohere и Jina: POST https://veselo.ai/v1/rerank.
ИИ-помощнику то же делает инструмент MCP rerank_documents — до 100 документов за раз (MCP-сервер).
Модели и цены
| id | Модель | Цена |
|---|---|---|
cohere/rerank-v5.0-pro | Cohere Rerank v5 Pro | 5,30 ₽ за 1 млн токенов |
cohere/rerank-v5.0-fast | Cohere Rerank v5 Fast | 2,12 ₽ за 1 млн токенов |
cohere/rerank-v4.0-pro | Cohere Rerank v4 Pro | 264,76 ₽ за 1000 поисков |
cohere/rerank-v4.0-fast | Cohere Rerank v4 Fast | 211,81 ₽ за 1000 поисков |
В GET /v1/models — записи с type: "rerank". Цена — за 1 млн токенов вопроса и документов, pricing_rub.input_per_1m; у моделей с ценой за поиск — per_1k_searches, за 1000 поисков (поиск — вопрос и до 100 документов). В поле rerank: сколько документов за запрос (max_documents) и сколько токенов в паре «вопрос — документ» (context_length).
Расставить документы
curl
curl https://veselo.ai/v1/rerank \
-H "Authorization: Bearer $VESELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "cohere/rerank-v5.0-fast",
"query": "Сколько спят коты?",
"documents": ["Эльбрус — самая высокая гора России.", "Кошки спят до 16 часов в сутки.", "Чайник от накипи чистят лимонной кислотой."],
"top_n": 2,
"return_documents": true
}'Python
import os, requests # pip install requests
r = requests.post(
"https://veselo.ai/v1/rerank",
headers={"Authorization": f"Bearer {os.environ['VESELO_API_KEY']}"},
json={
"model": "cohere/rerank-v5.0-fast",
"query": "Сколько спят коты?",
"documents": ["Эльбрус — самая высокая гора России.", "Кошки спят до 16 часов в сутки.", "Чайник от накипи чистят лимонной кислотой."],
"top_n": 2,
},
timeout=120,
)
r.raise_for_status()
for x in r.json()["results"]:
print(x["index"], round(x["relevance_score"], 3))JavaScript
const res = await fetch('https://veselo.ai/v1/rerank', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.VESELO_API_KEY}`, 'Content-Type': 'application/json' },
body: JSON.stringify({
model: 'cohere/rerank-v5.0-fast',
query: 'Сколько спят коты?',
documents: ['Эльбрус — самая высокая гора России.', 'Кошки спят до 16 часов в сутки.', 'Чайник от накипи чистят лимонной кислотой.'],
top_n: 2,
}),
});
const r = await res.json();
if (!res.ok) throw new Error(r.error.message);
console.log(r.results, r.usage.cost_rub, '₽');Ответ
{
"id": "rerank-req_5b2e9c0d41f84a7f9e3c2a1b0d6f8e47",
"model": "cohere/rerank-v5.0-fast",
"results": [
{ "index": 1, "relevance_score": 0.93, "document": { "text": "Кошки спят до 16 часов в сутки." } },
{ "index": 2, "relevance_score": 0.04, "document": { "text": "Чайник от накипи чистят лимонной кислотой." } }
],
"usage": { "prompt_tokens": 61, "total_tokens": 61, "cost_rub": 0.01 }
}Оценки и цена в примере ответа условные.
Поля запроса
| Поле | Что передать |
|---|---|
model | обязательно: id модели с type: "rerank" |
query | обязательно: вопрос — непустая строка до 10 000 знаков |
documents | обязательно: от 1 до 1 000 документов — строки или объекты {"text": …}, непустые |
top_n | сколько лучших вернуть: от 1 до числа документов; по умолчанию — все |
return_documents | true — вернуть и текст документа (results[].document.text); по умолчанию false — только номер и оценка |
Другие поля — 400 с именем поля в param.
Ответ
results— сначала самые подходящие:index— номер документа в запросе (с нуля),relevance_score— оценка,document.text— если просили.usage— по каким числам списано:prompt_tokensиtotal_tokens, у цены за поиск — ещёsearch_units;cost_rub— цена.- Заголовки —
x-veselo-cost-rub,x-veselo-balance-rubиx-request-id.
Деньги и лимиты
- Удерживается оценка токенов: вопрос считается заново с каждым документом, примерно токен на 2 знака. Списывается — по
usageответа, а если модель не назвала числа — по оценке. Ошибка — 0 ₽. - До 1 000 документов за запрос; длинный документ раздели на части — пара «вопрос — документ» должна помещаться в
rerank.context_lengthтокенов. Тело — до 25 МБ, ответ модели — до 2 минут. Общие лимиты ключа — 60 запросов в минуту и 10 одновременных. - Ошибки — как у эмбеддингов: 400 с
param, 402, 404, 413, 429, 502, 503 сalternatives, 504.