Документация

Selector: инструкция

Открыть API reference

Зачем нужен Selector

Selector это единая точка входа к разным LLM-провайдерам; сам Selector предоставляет Ollama-совместимый API. Он позволяет:

Ключевая идея: клиент всегда говорит с одним сервером Selector, а внутри можно менять пул моделей без изменения клиента.

Единый API Автовыбор модели

Как пользоваться (практически)

1) Откройте веб-панель

2) Зарегистрируйтесь и дождитесь подтверждения администратором

3) Создайте API ключ

4) Делайте запросы как в Ollama, но на адрес Selector

Основной рабочий режим: используйте model: \"selector\" и передавайте ваш текст.

curl -X POST http://HOST:11400/api/chat \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <SELECTOR_API>" \
  -d '{
    "model":"selector",
    "messages":[{"role":"user","content":"Ты кто?"}],
    "stream":false
  }'

Что показывает сайт /info

Таблица Providers

Таблица Models

Роли и права

  • guest может только смотреть публичный мониторинг; адреса локальных и глобальных узлов маскируются.
  • user может работать с API ключами, менять пароль и отправлять запросы в пределах баланса.
  • admin может подтверждать регистрации, управлять пользователями, паролями, ролями и балансом.

Баллы и ограничения

  • Стартовый баланс пользователя: 1000 баллов.
  • Если баланс перестаёт быть положительным, инференс для обычного пользователя блокируется.
  • Стоимость зависит от токенов, размера модели и типа модели (локальная/облачная).
  • Администраторы могут выполнять запросы независимо от баланса.

Конфиденциальность и чувствительный контент

Публикация своих ресурсов

Linux

./share_resource_linux.sh \
  --selector-url https://selector.chat-artin.ru \
  --selector-api-key sel_ВАШ_API_КЛЮЧ \
  --kind ollama \
  --base-url http://127.0.0.1:11434 \
  --label "home-ollama"

Windows

share_resource_windows.bat ^
  --selector-url https://selector.chat-artin.ru ^
  --selector-api-key sel_ВАШ_API_КЛЮЧ ^
  --kind lmstudio ^
  --base-url http://127.0.0.1:1234 ^
  --label "home-lmstudio"

Автозапуск

В личном кабинете на странице /info есть панель Shared Resources с готовыми командами запуска и кнопками копирования для Linux и Windows.

Настройка Codex на Selector

Codex в режиме --oss может работать через Selector как через Ollama-compatible endpoint. Для этого укажите адрес Selector в CODEX_OSS_BASE_URL и передайте API ключ в URL (Basic auth).

Быстрый запуск (Linux/macOS)

#!/usr/bin/env bash
export CODEX_OSS_BASE_URL="https://sel_ВАШ_API_КЛЮЧ:@selector.chat-artin.ru"
codex --oss --model gpt-oss:20b

Важно

Проверка подключения

curl -sS -u "sel_ВАШ_API_КЛЮЧ:" https://selector.chat-artin.ru/api/tags

Если возвращается JSON с моделями, Codex сможет подключиться.

Где смотреть состояние системы

API reference

Подробный список всех endpoint-ов, назначение каждого, форматы запросов/ответов и примеры:

Перейти к API reference

Работа с моделями из UI (admin/user)

Регистрация и администрирование