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-совместимый формат — одна интеграция вместо десятков.
Автофолбэки
Передавайте fallback-цепочку поддерживаемому upstream-агрегатору. Переключение зависит от его политики и доступности моделей.
PII-маскирование
ФИО, телефоны, СНИЛС, адреса маскируются до отправки и восстанавливаются в ответе — 152-ФЗ из коробки.
Rate limits и квоты
Лимиты на ключ, на ключа × модель, на организацию. Прозрачные заголовки X-RateLimit-*.
Прозрачные цены
+10% к прайсу провайдера — никаких абонентских платежей и скрытых комиссий. Оплата строго по факту использования.
Аудит и логи
Полный журнал запросов, масок, провайдеров и ошибок. Экспорт в S3 и выгрузка для compliance.

Endpoints

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

POST
/v1/chat/completions

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

POST
/v1/decisions

Типизированные решения TypeSafe Jev: вероятность, выбор категории и оценка

POST
/v1/embeddings

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

POST
/v1/rerank

Пересортировка текстовых документов по релевантности запросу

POST
/v1/images

Синхронная генерация изображений в OpenRouter-совместимом формате

POST
/v1/videos

Асинхронная генерация видео

GET
/v1/videos/{job_id}

Статус задачи генерации видео

GET
/v1/videos/{job_id}/content

Скачивание готового видео

GET
/v1/models

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

GET
/v1/models/{model_id}

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

GET
/v1/catalog/models

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

Два формата каталога моделей
/v1/models требует API-ключ и возвращает object: list и data[]с компактными полями id, object, owned_by, context_window, api_surfaces, pricing_basis и ценами за миллион токенов. Для реранкеров pricing_basis: provider_reported означает оплату по фактической стоимости провайдера: нулевые токенные цены не означают бесплатный запрос. /v1/models/{model_id} возвращает одну такую карточку без обёртки data. Для возможностей модели используйте публичный /v1/catalog/models?limit=100&offset=0: ответ содержит items, total и facets, а карточки — supported_parameters, context_length и модальности. Подробная карточка доступна по /v1/catalog/models/{model_id}. Публичный каталог не проверяет allowlist вашего ключа; доступ к генерации проверяется отдельно.

Дальше

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

Аутентификация
Как получить API-ключ, типы ключей, best practices
Быстрый старт
cURL, Python, Node.js, Go — готовые сниппеты
Decisions: TypeSafe Jev
Вопросы noul, choice и score, примеры запросов и ответов
Реранжирование
Релевантность документов, RAG и тарификация запросов
Изображения и видео
Генерация, polling, скачивание файлов и тарификация
Стриминг
Как читать Server-Sent Events и token-by-token ответы
PII-маскирование
Как работает защита данных на уровне шлюза
Далее
Аутентификация