Light
Справочник разработчика

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

Техническое описание HTTP-маршрутов, заголовков авторизации, потоковой передачи Server-Sent Events (SSE), механизма резервирования квот и обработки статусов ответа.

Доступность конкретного протокола и инструментов зависит от модели и поставщика. Статус подключения в каталоге не означает проверку всех функций.

Базовый адрес и авторизация

Публичный адрес API взят из серверной конфигурации.

Все обращения к шлюзу выполняются по базовому префиксу https://api.lightapi.app/v1. Для авторизации передавай секретный ключ в заголовке Authorization: Bearer <API_KEY> (для маршрутов OpenAI и Anthropic) или x-api-key: <API_KEY> с заголовком anthropic-version: 2023-06-01 (для протокола Anthropic).

curl https://api.lightapi.app/v1/models \
  -H "Authorization: Bearer $LGHT_API_KEY"

Запрос GET /v1/models возвращает список моделей, разрешенных для данного ключа и активных в текущем режиме расчета кошелька.

Протокол OpenAI: Chat Completions

Запрос POST /v1/chat/completions

Стандартный маршрут для отправки диалоговых сообщений и получения полного или потокового ответа.

curl https://api.lightapi.app/v1/chat/completions \
  -H "Authorization: Bearer $LGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "max_tokens": 512,
    "messages": [
      {"role": "user", "content": "Кратко объясни разницу между процессом и потоком."}
    ]
  }'

Потоковый режим (SSE)

Для получения токенов по мере генерации укажи "stream": true. Если соединение обрывается клиентом после начала генерации текста, фактический расход фиксируется и сверяется по журналу шлюза.

Протокол Anthropic: Messages API

Запрос POST /v1/messages

Совместимый маршрут для клиентов и CLI-утилит (включая Claude Code), работающих по спецификации Anthropic Messages API.

curl https://api.lightapi.app/v1/messages \
  -H "Authorization: Bearer $LGHT_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "max_tokens": 512,
    "messages": [
      {"role": "user", "content": "Проверь сложность алгоритма бинарного поиска."}
    ]
  }'

Резервирование квот, списания и обработка ошибок

Предварительный резерв без ухода в минус

Перед передачей платного текстового запроса поставщику шлюз резервирует верхнюю оценку стоимости входа и выхода с округлением вверх. При нехватке баланса кошелька или остатка лимита ключа запрос отклоняется до вызова поставщика (HTTP 403/402) с нулевым расходом. После завершения ответа неиспользованный резерв автоматически возвращается.

Устойчивость к перезапуску шлюза

Активные резервы фиксируются в постоянном журнале. При нештатной остановке или перезапуске шлюза незавершенные резервы возвращаются на баланс, а подтвержденные списания сохраняются без дублирования.

Честные статусы ответа без автоповторов

Пустой ответ, рассуждения без видимого текста (reasoning_limit), достижение лимита длины (finish_reason=length), фильтрация поставщиком и обрыв потока получают явные статусы. Частичный ответ никогда не выдается за полный, а платные запросы не повторяются автоматически за твой счет.

Правила бесплатного режима и хранения истории

Бесплатный режим: до 10 запросов в день без входа и до 50 после входа (вход до 2024 токенов, выход до 512 токенов). В бесплатном чате сохраняются последние 5 сообщений, в платном чате - история диалога. Чаты на сайте хранятся до тех пор, пока ты не удалишь их вручную. В платном чате сохраняется история диалога, в бесплатном - до 5 последних сообщений. Удаление убирает сообщения и название диалога из рабочего хранилища. API в Light работает строго в режиме no-log для содержимого: тексты запросов и ответов не сохраняются. Остается только технический и расчетный учет: время, модель, токены, стоимость, ключ, IP-адрес и статусы обработки. Удаление диалога из рабочего хранилища не означает немедленного удаления его прежних данных из уже созданных резервных копий. No-log относится к хранению в Light. Запрос передается выбранному поставщику для генерации ответа; у поставщика и Telegram действуют собственные правила обработки данных.