Перейти к содержимому

Начало работы

ru-llm — это LLM-прокси, «OpenRouter для РФ». Единый шлюз предоставляет одновременно OpenAI-совместимый API (/v1/chat/completions) и Anthropic-совместимый API (/v1/messages) и прозрачно маршрутизирует запросы к провайдерам LLM.

Главное:

  • Один базовый URL: https://api.ru-llm.relay2.xyz (URL вашего шлюза — замените при self-hosting)
  • Одна схема авторизации: ключи sk-ru-…, передаются через Authorization: Bearer или x-api-key
  • Оба API принимают любой из этих заголовков
  • Предоплаченный баланс в USD; списывается стоимость фактически использованных токенов по розничным тарифам моделей

Настройка аккаунта

  1. Создайте аккаунт

    Зарегистрируйтесь на ru-llm.relay2.xyz. Аутентификация работает на Kratos — используйте email с паролем или поддерживаемый соцпровайдер.

  2. Пополните баланс

    Откройте раздел Billing в консоли и внесите средства через крипту/USDT. Баланс — предоплаченный в USD; списания происходят по мере расхода токенов.

  3. Создайте API-ключ

    В разделе API Keys нажмите Create key. Скопируйте сгенерированный ключ sk-ru-… — он показывается только один раз.

Ваш первый запрос

Замените sk-ru-YOUR_KEY на ваш реальный ключ в примерах ниже.

OpenAI-совместимый (chat completions)

Окно терминала
curl https://api.ru-llm.relay2.xyz/v1/chat/completions \
-H "Authorization: Bearer sk-ru-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"messages": [{"role": "user", "content": "Hello, world!"}]
}'

Anthropic-совместимый (messages)

Окно терминала
curl https://api.ru-llm.relay2.xyz/v1/messages \
-H "x-api-key: sk-ru-YOUR_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 256,
"messages": [{"role": "user", "content": "Hello, world!"}]
}'

Потоковый режим

Оба API поддерживают потоковую передачу через Server-Sent Events. Добавьте "stream": true в тело запроса:

Окно терминала
curl https://api.ru-llm.relay2.xyz/v1/chat/completions \
-H "Authorization: Bearer sk-ru-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"messages": [{"role": "user", "content": "Count to five."}],
"stream": true
}'

Дальше