Начало работы
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; списывается стоимость фактически использованных токенов по розничным тарифам моделей
Настройка аккаунта
-
Создайте аккаунт
Зарегистрируйтесь на ru-llm.relay2.xyz. Аутентификация работает на Kratos — используйте email с паролем или поддерживаемый соцпровайдер.
-
Пополните баланс
Откройте раздел Billing в консоли и внесите средства через крипту/USDT. Баланс — предоплаченный в USD; списания происходят по мере расхода токенов.
-
Создайте 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 }'Дальше
- Обзор API — базовые URL, авторизация, все эндпоинты
- Справочник OpenAI-совместимого API — полная спецификация
chat/completions - Справочник Anthropic-совместимого API — полная спецификация
messages - Модели и цены — доступные модели и тарифы