Справочник разработчика
Документация 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 действуют собственные правила обработки данных.