Обзор API
Базовый URL
https://api.ru-llm.relay2.xyzПри self-hosting замените на URL вашего шлюза.
API-поверхности
ru-llm предоставляет две полностью совместимые API-поверхности на одном шлюзе:
| Поверхность | Базовый путь | Протокол |
|---|---|---|
| OpenAI-совместимая | /v1 | OpenAI Chat Completions API |
| Anthropic-совместимая | /v1 | Anthropic Messages API |
Поверхность определяется эндпоинтом, который вы вызываете, а не настройкой.
Авторизация
Все запросы требуют ключ sk-ru-…. Оба API принимают любой из заголовков:
Authorization: Bearer sk-ru-YOUR_KEYx-api-key: sk-ru-YOUR_KEYСоздавайте и управляйте ключами в консоли → API-ключи.
Эндпоинты
OpenAI-совместимые
| Метод | Путь | Описание |
|---|---|---|
POST | /v1/chat/completions | Chat completion (потоковый или обычный) |
GET | /v1/models | Список доступных моделей |
Anthropic-совместимые
| Метод | Путь | Описание |
|---|---|---|
POST | /v1/messages | Messages API (потоковый или обычный) |
GET | /v1/models | Список доступных моделей |
Кросс-диалектная маршрутизация
Это значит, что ваш существующий код на OpenAI SDK может обращаться к моделям Claude без изменений в SDK — достаточно указать base_url на шлюз и сменить ID модели.
Типы содержимого
Все тела запросов и ответов — JSON (Content-Type: application/json). Потоковые ответы используют text/event-stream (Server-Sent Events).
Версионирование
- OpenAI-поверхность: заголовок версии не требуется.
- Anthropic-поверхность: передавайте
anthropic-version: 2023-06-01(или новее) в заголовках запроса.