# LeinAPI

> LeinAPI — API для текстовых моделей, генерации и редактирования изображений и видео. Основной адрес: https://leinapi.com. Возможности и цены проверяйте по текущему каталогу перед запросом.

## Адреса и правила

- API origin: https://leinapi.com
- OpenAI SDK base_url: https://leinapi.com/v1
- MCP Streamable HTTP: https://leinapi.com/mcp
- Авторизация: Authorization: Bearer $LEIN_API_KEY. Ключ хранится в окружении, никогда в URL.
- Для выбора модели: GET https://leinapi.com/v1/models с ключом; используйте точный id и одну совместимую capability.
- Текст: Chat Completions, Responses, Messages, Gemini — только объявленные моделью режимы. Полная взаимозаменяемость протоколов не обещается.
- Исходники: base64 data URI прямо в JSON генерации; отдельный upload и ID входного файла не нужны.
- Медиа: сохраняйте Idempotency-Key до POST, затем id задачи; опрашивайте состояние, не создавайте новую генерацию при тайм-ауте.
- Результаты: GET /v1/tasks/{id}/content?index=N с Bearer-ключом; N от 0 до result_count−1.
- Цены — точные десятичные строки RUB. Отсутствующий тариф не означает нулевую стоимость.
- Не подменяйте модель, не отбрасывайте значимые параметры и не обходите квоты автоматически.

## Руководство

- [Начало и навигация](https://leinapi.com/agent-guide/README.md)
- [Быстрый старт: Python, OpenAI SDK, полный цикл медиа](https://leinapi.com/agent-guide/quickstart.md)
- [Алгоритм работы агента](https://leinapi.com/agent-guide/agent.md)
- [Авторизация, каталог, capabilities и статус](https://leinapi.com/agent-guide/auth-models.md)
- [Текст: JSON, SSE, четыре протокола](https://leinapi.com/agent-guide/text.md)
- [Анализ изображений текстовыми моделями](https://leinapi.com/agent-guide/vision.md)
- [Изображения: генерация, редактирование, пакеты](https://leinapi.com/agent-guide/images.md)
- [Видео: режимы, кадры и референсы](https://leinapi.com/agent-guide/videos.md)
- [Вложения: base64 в одном запросе](https://leinapi.com/agent-guide/files.md)
- [Задачи: опрос, отмена, скачивание](https://leinapi.com/agent-guide/tasks.md)
- [Ошибки, повторные запросы и идемпотентность](https://leinapi.com/agent-guide/errors-idempotency.md)
- [Совместимость, инструменты и границы протоколов](https://leinapi.com/agent-guide/compatibility.md)
- [Цены и выбор тарифа](https://leinapi.com/agent-guide/pricing.md)
- [Баланс, резервы, бюджеты и пополнение](https://leinapi.com/agent-guide/billing.md)
- [История, статистика и песочница](https://leinapi.com/agent-guide/usage.md)
- [MCP: подключение и доступные инструменты](https://leinapi.com/agent-guide/mcp.md)

## Машиночитаемые источники

- [Полное руководство одним файлом](https://leinapi.com/llms-full.txt)
- [OpenAPI JSON](https://leinapi.com/api/openapi.json)
- [Публичный каталог моделей и возможностей](https://leinapi.com/api/public/models)
- [Текущие цены RUB](https://leinapi.com/api/public/pricing)
- [Интерактивная API-справка](https://leinapi.com/api/docs)
- [Документация каждой модели](https://leinapi.com/#docs/models)

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