Reranker

Инструмент интеллектуальной переоценки и ранжирования текстов. Используется в сценариях Retrieval-Augmented Generation (RAG): улучшает качество ответов, помогая выбирать наиболее релевантные документы из набора результатов поиска. Полезен при создании чат-ботов, ассистентов и систем поиска знаний.

• Ссылка на модель на Hugging Face

Шаг 1. Откройте Reranker и нажмите «Получить API-ключ»

Чтобы получить API-ключ, нажмите Получить API-ключ

Шаг 2. Создание API-ключа

Для создания API-ключа введите название

Что вы получите на AlemCloud:

• API Key

Чтобы его использовать, сделайте запрос: POST https://llm.alem.ai/v1/rerank

Headers: Authorization: Bearer API Key

Пример использования

Python Node.js PHP

import requests

API_KEY = "YOUR_API_KEY"  # <-- сюда вставь реальный ключ
URL = "https://llm.alem.ai/v1/rerank"

payload = {
    "model": "reranker",
    "query": "Какие преимущества у электромобилей?",
    "documents": [
        "Электромобили дешевле в обслуживании.",
        "Бензиновые машины имеют большой запас хода.",
        "Экологичность — ключевое преимущество электромобилей.",
        "Электромобили медленно заряжаются.",
    ],
    "top_n": 3,
}


def main():
    try:
        resp = requests.post(
            URL,
            headers={
                "Authorization": f"Bearer {API_KEY}",
                "Content-Type": "application/json",
            },
            json=payload,
            timeout=60,
        )
        resp.raise_for_status()
        data = resp.json()
        print(data)  # можно потом заменить на красивый вывод top_n
    except requests.RequestException as e:
        print(f"Request failed: {e}\nBody: {resp.text if 'resp' in locals() else ''}")


if __name__ == "__main__":
    main()

const URL = "https://llm.alem.ai/v1/rerank";
const API_KEY = "YOUR_API_KEY"; // <-- сюда ключ

const payload = {
  model: "reranker",
  query: "Какие преимущества у электромобилей?",
  documents: [
    "Электромобили дешевле в обслуживании.",
    "Бензиновые машины имеют большой запас хода.",
    "Экологичность — ключевое преимущество электромобилей.",
    "Электромобили медленно заряжаются.",
  ],
  top_n: 3,
};

async function main() {
  const resp = await fetch(URL, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(payload),
  });

  if (!resp.ok) {
    throw new Error(`HTTP ${resp.status} ${await resp.text()}`);
  }

  const data = await resp.json();
  console.log(data); // при желании можно вывести только отсортированные документы
}

main().catch((err) => {
  console.error("Reranker request failed:", err);
  process.exit(1);
});

<?php
declare(strict_types=1);

$API_KEY = 'YOUR_API_KEY';              // <-- сюда ключ
$URL     = 'https://llm.alem.ai/v1/rerank';

$payload = [
  'model'    => 'reranker',
  'query'    => 'Какие преимущества у электромобилей?',
  'documents' => [
    'Электромобили дешевле в обслуживании.',
    'Бензиновые машины имеют большой запас хода.',
    'Экологичность — ключевое преимущество электромобилей.',
    'Электромобили медленно заряжаются.',
  ],
  'top_n'    => 3,
];

$ch = curl_init($URL);
curl_setopt_array($ch, [
  CURLOPT_POST           => true,
  CURLOPT_HTTPHEADER     => [
    'Authorization: Bearer ' . $API_KEY,
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS     => json_encode($payload, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_TIMEOUT        => 60,
]);

$raw = curl_exec($ch);
if ($raw === false) {
  throw new RuntimeException('cURL error: ' . curl_error($ch));
}
$code = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

if ($code < 200 || $code >= 300) {
  throw new RuntimeException("HTTP $code: $raw");
}

$data = json_decode($raw, true);
echo json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_PRETTY_PRINT);

---

---

Рассмотрим как получить протестировать Reranker с помощью POSTMAN.

Укажите метод POST и свой API-KEY

В разделе Authorization укажите свой API-KEY

Укажите KEY и VALUE

Перейдите в Headers и укажите так

Укажите model и input

Перейдите в Body и укажите Json

Нажмите Send

Вы получите ответ от reranker

---

Как сочетать Reranker с другими сервисами

• Оркестрация/агенты: n8n

---