---
title: "Переранжирование (rerank) по API за рубли"
description: "Rerank по API: документы по порядку смысла вопроса, до 1 000 документов за запрос, top_n и оценки relevance_score. Цена в рублях, формат как у Cohere."
url: https://veselo.ai/docs/rerank
updated: 2026-11-17T01:27:17.429Z
---

# Переранжирование (rerank) по API за рубли

Rerank по API: документы по порядку смысла вопроса, до 1 000 документов за запрос, top_n и оценки relevance_score. Цена в рублях, формат как у Cohere.

Обновлено: 17 ноября 2026 г.

Переранжирование (rerank) берёт вопрос и список документов и возвращает их по порядку: сначала самые подходящие по смыслу, с оценкой. Так уточняют результаты поиска: эмбеддинги или поиск по словам находят 50–100 кандидатов, rerank выбирает лучшие — и только они уходят в чат как контекст. Формат — как у rerank в Cohere и Jina: `POST https://veselo.ai/v1/rerank`.

ИИ-помощнику то же делает инструмент MCP `rerank_documents` — до 100 документов за раз ([MCP-сервер](https://veselo.ai/docs/mcp#tools)).

## Модели и цены

**Переранжирование и цена — в рублях**

| id | Модель | Цена |
| --- | --- | --- |
| `cohere/rerank-v5.0-pro` | [Cohere Rerank v5 Pro](https://veselo.ai/models/cohere/rerank-v5.0-pro) | 5,30 ₽ за 1 млн токенов |
| `cohere/rerank-v5.0-fast` | [Cohere Rerank v5 Fast](https://veselo.ai/models/cohere/rerank-v5.0-fast) | 2,12 ₽ за 1 млн токенов |
| `cohere/rerank-v4.0-pro` | [Cohere Rerank v4 Pro](https://veselo.ai/models/cohere/rerank-v4.0-pro) | 264,76 ₽ за 1000 поисков |
| `cohere/rerank-v4.0-fast` | [Cohere Rerank v4 Fast](https://veselo.ai/models/cohere/rerank-v4.0-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 одновременных.
- Ошибки — как у [эмбеддингов](https://veselo.ai/docs/embeddings#money): 400 с `param`, 402, 404, 413, 429, 502, 503 с `alternatives`, 504.

[← Эмбеддинги](https://veselo.ai/docs/embeddings) · [SDK и программы →](https://veselo.ai/docs/sdks)

[Вся документация одним текстом](https://veselo.ai/docs/llms.txt) · [Все модели и цены](https://veselo.ai/models)

## Разделы документации

### Начало

- [Быстрый старт](https://veselo.ai/docs)
- [Ключи](https://veselo.ai/docs/auth)
- [Цены и списания](https://veselo.ai/docs/pricing)
- [Команды](https://veselo.ai/docs/teams)
- [Оплата для компаний](https://veselo.ai/docs/business)
- [Модели](https://veselo.ai/docs/models)

### Как сделать

- [Сообщения и параметры](https://veselo.ai/docs/chat)
- [Стриминг](https://veselo.ai/docs/streaming)
- [Вызов функций](https://veselo.ai/docs/tools)
- [Ответ в JSON](https://veselo.ai/docs/structured-output)
- [Провайдеры](https://veselo.ai/docs/providers)
- [Без цензуры](https://veselo.ai/docs/uncensored)
- [Картинки во входе](https://veselo.ai/docs/vision)
- [Картинки](https://veselo.ai/docs/images)
- [Видео](https://veselo.ai/docs/video)
- [Озвучка](https://veselo.ai/docs/speech)
- [Голоса](https://veselo.ai/docs/voices)
- [Музыка](https://veselo.ai/docs/music)
- [Распознавание речи](https://veselo.ai/docs/transcriptions)
- [Эмбеддинги](https://veselo.ai/docs/embeddings)
- **Переранжирование**
- [SDK и программы](https://veselo.ai/docs/sdks)
- [Claude Code](https://veselo.ai/docs/anthropic)
- [Ключ для нейросети](https://veselo.ai/docs/agents)
- [MCP](https://veselo.ai/docs/mcp)

### Справочник

- [Методы API](https://veselo.ai/docs/reference)
- [Ошибки](https://veselo.ai/docs/errors)
- [Лимиты](https://veselo.ai/docs/limits)
- [Заголовки](https://veselo.ai/docs/headers)

### Ещё

- [Вопросы](https://veselo.ai/docs/faq)
- [Данные и приватность](https://veselo.ai/docs/privacy)
- [Изменения](https://veselo.ai/docs/changelog)
