# Hubris

> OpenAI-совместимый шлюз к 400+ LLM. Оплата картой РФ или СБП. Без VPN и зарубежных карт.

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

- [Аутентификация](https://hubris.pw/docs/authentication.mdx): API-ключи Hubris в формате sk-gw-, заголовок Bearer, безопасное хранение и ротация.
- [Changelog](https://hubris.pw/docs/changelog.mdx): Записи о breaking changes API, новых моделях, обновлениях платформы Hubris.
- [FAQ](https://hubris.pw/docs/faq.mdx): Часто задаваемые вопросы про Hubris API, биллинг, ключи, поддерживаемые модели.
- [Документация Hubris](https://hubris.pw/docs.mdx): OpenAI-совместимый LLM-агрегатор с оплатой в рублях. Один ключ ко всем ведущим моделям.
- [Документация для AI](https://hubris.pw/docs/llms-txt.mdx): Скормите всю документацию Hubris в ChatGPT, Claude или любого AI-агента одной ссылкой — и спрашивайте на естественном языке.
- [Миграция с OpenAI](https://hubris.pw/docs/migration-from-openai.mdx): Как переключиться с OpenAI на Hubris — что меняется, что 1-в-1.
- [Быстрый старт](https://hubris.pw/docs/quickstart.mdx): Первый запрос к Hubris за 60 секунд. Примеры на cURL, Python, TypeScript и OpenAI SDK.
- [Статус сервиса](https://hubris.pw/docs/status.mdx): Текущая доступность Hubris API и историческая аптайм-статистика.
- [Поддержка](https://hubris.pw/docs/support.mdx): Как связаться с командой Hubris — баги, вопросы, фичи, биллинг.
- [Hello world](https://hubris.pw/docs/_sandbox/hello.mdx): Демо-страница со всеми компонентами документации.
- [POST /v1/chat/completions](https://hubris.pw/docs/api/chat-completions.mdx): Создать chat completion. OpenAI-совместимый формат, поддержка стриминга, tool calling, structured outputs, vision.
- [POST /v1/embeddings](https://hubris.pw/docs/api/embeddings.mdx): Создать эмбеддинги — вектор фиксированной длины из текста. OpenAI-совместимый формат.
- [POST /v1/messages](https://hubris.pw/docs/api/messages.mdx): Эндпоинт, совместимый с Anthropic Messages API. Используется Claude Code и любым SDK Anthropic.
- [GET /v1/models](https://hubris.pw/docs/api/models.mdx): Список доступных моделей с актуальными ценами в рублях.
- [Обзор API](https://hubris.pw/docs/api/overview.mdx): Базовый URL, заголовки, аутентификация и общие соглашения Hubris API.
- [POST /v1/responses (бета)](https://hubris.pw/docs/api/responses.mdx): Эндпоинт OpenAI Responses API. Подходит для рассуждающих моделей и агентов.
- [Потоковая передача](https://hubris.pw/docs/api/streaming.mdx): Формат Server-Sent Events для потокового ответа /v1/chat/completions.
- [GET /v1/usage](https://hubris.pw/docs/api/usage.mdx): Расход по API-ключу за выбранный период. Удобно для дашбордов и алертов.
- [Биллинг](https://hubris.pw/docs/concepts/billing.mdx): Баланс, минимальный остаток, пополнение через СБП, поведение при нехватке средств.
- [Ошибки](https://hubris.pw/docs/concepts/errors.mdx): Формат ответа об ошибке, таблица всех кодов, что делать в каждом случае.
- [Бесплатные модели](https://hubris.pw/docs/concepts/free-models.mdx): 25+ моделей с нулевой ценой — Llama, Gemma, Liquid, BGE и другие. Лимит 100 запросов в сутки на пользователя.
- [Модели](https://hubris.pw/docs/concepts/models.mdx): Каталог моделей Hubris, формат GET /v1/models, как выбрать модель под задачу.
- [Цены](https://hubris.pw/docs/concepts/pricing.mdx): Как считается стоимость запроса в рублях. Таблицы цен — в каталоге моделей.
- [Конфиденциальность](https://hubris.pw/docs/concepts/privacy.mdx): Что Hubris хранит и не хранит о ваших запросах. Передача данных провайдерам моделей.
- [Rate limits](https://hubris.pw/docs/concepts/rate-limits.mdx): Что ограничивает запросы в Hubris — баланс, апстрим, дневные лимиты на служебных ключах.
- [Обработка ошибок](https://hubris.pw/docs/features/error-handling.mdx): Стратегия retry, backoff, комбинация с model fallbacks и что показывать конечному пользователю.
- [Генерация изображений](https://hubris.pw/docs/features/image-generation.mdx): Генерация изображений через /v1/chat/completions. Передайте `modalities: ["image","text"]` и модель с поддержкой image-output.
- [Model Fallbacks](https://hubris.pw/docs/features/model-fallbacks.mdx): Запасные модели на случай 429/5xx/контент-фильтра. Передайте массив `models` — Hubris сам переключится при сбое.
- [Выбор модели программно](https://hubris.pw/docs/features/model-selection.mdx): Как фильтровать каталог через GET /v1/models, подбирать модель под задачу и обрабатывать переименования.
- [Privacy Mode](https://hubris.pw/docs/features/privacy.mdx): Автоматическое маскирование персональных данных перед отправкой к провайдеру.
- [Кеширование промптов (Anthropic)](https://hubris.pw/docs/features/prompt-caching.mdx): Кеширование длинных промптов для удешевления повторных вызовов с тем же контекстом.
- [Reasoning токены](https://hubris.pw/docs/features/reasoning.mdx): Контроль над reasoning-моделями (o1, R1, Claude thinking) через параметр reasoning_effort.
- [Стриминг ответов](https://hubris.pw/docs/features/streaming.mdx): Когда включать `stream: true`, как корректно собирать ответ модели и показывать прогресс пользователю.
- [Структурированный вывод](https://hubris.pw/docs/features/structured-output.mdx): Получение ответа строго в формате JSON по заданной схеме — без парсинга текста и без шанса получить «почти-JSON».
- [Вызов инструментов (tool calling)](https://hubris.pw/docs/features/tool-calling.mdx): Подключение функций к моделям — модель просит вызвать вашу функцию, вы исполняете её локально, отдаёте результат и получаете финальный ответ.
- [Мониторинг расходов](https://hubris.pw/docs/features/usage-tracking.mdx): Программный учёт трат через GET /v1/usage — отслеживание расхода по ключу, бюджет-алёрты, отчёты.
- [Изображения на вход (Vision)](https://hubris.pw/docs/features/vision.mdx): Отправка изображений в модель для анализа — описание содержимого, OCR, классификация, ответы на вопросы по картинке.
- [Поиск в интернете](https://hubris.pw/docs/features/web-search.mdx): Server-side инструмент — модель сама ищет в интернете и пишет ответ с источниками. Никакого ручного исполнения у вас на стороне.
- [Codex CLI](https://hubris.pw/docs/frameworks/codex-cli.mdx): Подключить агентский CLI от OpenAI к Hubris через Responses API.
- [LangChain.js](https://hubris.pw/docs/frameworks/langchain-js.mdx): Подключить Hubris к LangChain.js через ChatOpenAI.
- [LangChain (Python)](https://hubris.pw/docs/frameworks/langchain-python.mdx): Подключить Hubris к LangChain через ChatOpenAI.
- [OpenAI SDK для Node.js](https://hubris.pw/docs/frameworks/openai-node.mdx): Использовать официальный openai пакет с Hubris — поменяйте baseURL и apiKey.
- [OpenAI SDK для Python](https://hubris.pw/docs/frameworks/openai-python.mdx): Использовать официальный openai пакет с Hubris — поменяйте base_url и api_key.
- [Vercel AI SDK](https://hubris.pw/docs/frameworks/vercel-ai-sdk.mdx): Подключить Hubris к Vercel AI SDK через @ai-sdk/openai-compatible.
- [Claude Code](https://hubris.pw/docs/integrations/claude-code.mdx): Подключение официального CLI-агента Claude Code к Hubris через эндпоинт /v1/messages — поддержка Sonnet, Opus, Haiku, кэширования, vision, статусной строки.
- [Cline (VS Code / Cursor)](https://hubris.pw/docs/integrations/cline.mdx): Подключение AI-ассистента Cline к Hubris — кодит, читает и пишет файлы, запускает терминал из вашего редактора.
- [Dify](https://hubris.pw/docs/integrations/dify.mdx): Подключение Hubris к Dify — низкокодовой LLM-платформе для построения чат-приложений, агентов и workflow.
- [Hermes Agent](https://hubris.pw/docs/integrations/hermes-agent.mdx): Подключение Hermes Agent от Nous Research — самообучающегося AI-агента с Telegram, памятью и веб-дашбордом — к Hubris.
- [Kilo Code (VS Code / PyCharm)](https://hubris.pw/docs/integrations/kilo-code.mdx): Подключение Kilo Code — AI-агента для VS Code и PyCharm — к Hubris.
- [MCP-сервер](https://hubris.pw/docs/integrations/mcp.mdx): Подключите Hubris к AI-агентам через Model Context Protocol — без хардкода API.
- [n8n](https://hubris.pw/docs/integrations/n8n.mdx): Подключение Hubris к n8n — низкокодовая платформа автоматизации, в которой можно собирать workflow с участием LLM.
- [OAuth 2.0 + PKCE](https://hubris.pw/docs/integrations/oauth.mdx): Стандартный OAuth flow для подключения сторонних приложений и MCP-клиентов (Claude Desktop, Cursor, Cline) без копирования root-ключа.
- [OpenClaw](https://hubris.pw/docs/integrations/openclaw.mdx): Подключение Hubris к OpenClaw — open-source AI-ассистенту для Telegram, WhatsApp, Discord и Slack.
- [OpenCode](https://hubris.pw/docs/integrations/opencode.mdx): Подключение терминального AI-агента OpenCode (sst.dev) к Hubris — Plan Mode, file-context, image drag-and-drop прямо в TUI.
- [Qwen Code CLI](https://hubris.pw/docs/integrations/qwen-code.mdx): Подключение Qwen Code — терминального AI-агента от Alibaba (форк gemini-cli) — к Hubris.
- [Roo Code](https://hubris.pw/docs/integrations/roo-code.mdx): Подключение Roo Code — AI-агента для VS Code с режимами Architect / Code / Ask / Debug — к Hubris.