API Reference · v1

KodikRouter API

Единый OpenAI-совместимый API к сотням LLM с автоматическими фолбэками, маскированием PII по 152-ФЗ и прозрачной тарификацией по прайсу провайдера.

Быстрый старт Получить ключ

Hello, world

Минимальный пример запроса на любом языке

bash
curl -X POST https://api.kodikrouter.ru/v1/chat/completions \
  -H "Authorization: Bearer $KODIK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "messages": [
      {"role": "user", "content": "Привет!"}
    ]
  }'
Drop-in замена для OpenAI SDK
Если вы уже используете openai, LangChain, LlamaIndex или Vercel AI SDK — достаточно изменить base_url и api_key. Остальной код работает без изменений.

Base URL

Все запросы к API начинаются с этого адреса

Base URLhttps://api.kodikrouter.ru/v1

Что умеет KodikRouter

Ключевые возможности шлюза

Единый API
Доступ к 350+ моделям через OpenAI-совместимый формат — одна интеграция вместо десятков.
Автофолбэки
Если провайдер отвечает 5xx, упал или перегружен — мы незаметно переключаемся на следующую модель.
PII-маскирование
ФИО, телефоны, СНИЛС, адреса маскируются до отправки и восстанавливаются в ответе — 152-ФЗ из коробки.
Rate limits и квоты
Лимиты на ключ, на ключа × модель, на организацию. Прозрачные заголовки X-RateLimit-*.
Прозрачные цены
+10% к прайсу провайдера — никаких абонентских платежей и скрытых комиссий. Оплата строго по факту использования.
Аудит и логи
Полный журнал запросов, масок, провайдеров и ошибок. Экспорт в S3 и выгрузка для compliance.

Endpoints

Основные пути API

POST
/v1/chat/completions

Генерация текста, чат, стриминг через SSE

POST
/v1/embeddings

Векторные представления текста

GET
/v1/models

Список моделей, доступных вашему API-ключу

GET
/v1/models/{model_id}

Метаданные конкретной модели

GET
/v1/catalog/models

Публичный каталог с фильтрами и facets

Дальше

Выберите, откуда продолжить

Аутентификация
Как получить API-ключ, типы ключей, best practices
Быстрый старт
cURL, Python, Node.js, Go — готовые сниппеты
Стриминг
Как читать Server-Sent Events и token-by-token ответы
PII-маскирование
Как работает защита данных на уровне шлюза
Далее
Аутентификация