Свои провайдеры (BYOK)
Custom Provider позволяет подключить любой API, совместимый с форматом OpenAI или Anthropic. Сюда входят как крупные облачные сервисы (OpenRouter, Groq, Mistral и другие), так и локальные прокси и любые самостоятельно развёрнутые серверы.
Добавление провайдера
Заголовок раздела «Добавление провайдера»Перейдите в настройки Kodik → Провайдер → Custom Provider → Добавить провайдера. Укажите следующие параметры:
| Поле | Описание |
|---|---|
| Название | Произвольное имя для отображения в интерфейсе |
| Базовый URL | Корневой адрес API (см. требования к URL) |
| API Key | Ключ авторизации (опционально, если эндпоинт не требует) |
| Формат | openai (по умолчанию) или anthropic |
| Пользовательские заголовки | Дополнительные HTTP-заголовки через интерфейс ключ–значение |
| Стриминг | Включён по умолчанию; отключите, если провайдер его не поддерживает |
После сохранения Kodik немедленно проверяет доступность провайдера и обновляет список его моделей.
Требования к URL
Заголовок раздела «Требования к URL»- Для удалённых (не локальных) эндпоинтов обязателен
https://. Использованиеhttp://допускается только дляlocalhost,127.0.0.1,::1, адресов.localи частных IP-диапазонов (10.x.x.x, 172.16–31.x.x, 192.168.x.x). - Эндпоинты
/responsesне поддерживаются — используйте базовый URL или путь/chat/completions. - Если вы вводите URL с суффиксом
/chat/completionsдля формата OpenAI или/messagesдля формата Anthropic, Kodik автоматически определяет правильный базовый путь.
Обнаружение моделей
Заголовок раздела «Обнаружение моделей»При добавлении или обновлении провайдера Kodik запрашивает список моделей по эндпоинту /models или /v1/models. Обнаруженные модели включаются в список выбора — вместе с метаданными: именем, описанием, размером контекстного окна и флагами поддержки изображений и инструментов, если провайдер их возвращает.
Если эндпоинт моделей недоступен или возвращает пустой список, Kodik всё равно позволит использовать провайдера — просто выберите модель вручную.
Индикатор здоровья
Заголовок раздела «Индикатор здоровья»Рядом с каждым провайдером в списке отображается цветной индикатор:
| Цвет | Статус | Описание |
|---|---|---|
| Зелёный | ok | Провайдер отвечает быстро |
| Жёлтый | degraded | Ответ занял более 3 секунд |
| Красный | unreachable | Провайдер недоступен или вернул ошибку |
Kodik проверяет здоровье каждого провайдера раз в минуту, запрашивая список его моделей. Статус обновляется автоматически без перезагрузки.
Автоматическое определение известных сервисов
Заголовок раздела «Автоматическое определение известных сервисов»Kodik распознаёт популярные сервисы по базовому URL и автоматически применяет подходящие настройки по умолчанию:
| Сервис | URL | Формат по умолчанию |
|---|---|---|
| OpenRouter | openrouter.ai | openai |
| Groq | groq.com | openai |
| Together AI | together.xyz | openai |
| Mistral | mistral.ai | openai |
| Perplexity | perplexity.ai | openai |
| Fireworks | fireworks.ai | openai |
| DeepSeek | deepseek.com | openai |
| LM Studio | localhost:1234 | openai |
| LiteLLM | localhost:4000 | openai |
Для нераспознанных URL Kodik использует формат openai по умолчанию. Вы можете переопределить любой параметр вручную.
Пользовательские заголовки
Заголовок раздела «Пользовательские заголовки»Раздел Пользовательские заголовки позволяет добавить произвольные HTTP-заголовки к каждому запросу. Это полезно, например, для аутентификации через X-Custom-Auth или для передачи параметров маршрутизации, специфичных для провайдера.
Изменение и удаление провайдеров
Заголовок раздела «Изменение и удаление провайдеров»Нажмите на карточку провайдера, чтобы открыть его настройки, и внесите необходимые изменения. Удалить провайдера можно кнопкой Удалить провайдера внутри той же карточки.