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

Обзор API

Базовый URL

https://api.ru-llm.relay2.xyz

При self-hosting замените на URL вашего шлюза.

API-поверхности

ru-llm предоставляет две полностью совместимые API-поверхности на одном шлюзе:

ПоверхностьБазовый путьПротокол
OpenAI-совместимая/v1OpenAI Chat Completions API
Anthropic-совместимая/v1Anthropic Messages API

Поверхность определяется эндпоинтом, который вы вызываете, а не настройкой.

Авторизация

Все запросы требуют ключ sk-ru-…. Оба API принимают любой из заголовков:

Authorization: Bearer sk-ru-YOUR_KEY
x-api-key: sk-ru-YOUR_KEY

Создавайте и управляйте ключами в консоли → API-ключи.

Эндпоинты

OpenAI-совместимые

МетодПутьОписание
POST/v1/chat/completionsChat completion (потоковый или обычный)
GET/v1/modelsСписок доступных моделей

Anthropic-совместимые

МетодПутьОписание
POST/v1/messagesMessages 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 (или новее) в заголовках запроса.