Документация · API нейросетей
Один API ко всем нейросетям и ИИ-агентам
GPT-5, Claude 4.6, Gemini 2.5 — все модели искусственного интеллекта (ИИ) через один OpenAI-совместимый эндпоинт. Замените только base_url — ваш код на Python, Node.js, TypeScript или LangChain работает без правок.
- Без VPN
- Картой РФ или СБП
- 50 ₽ при регистрации
- OpenAI SDK совместимо
quickstart · chat completion
from openai import OpenAI
client = OpenAI(
api_key="sk-rubik-...", # ключ из /app/keys
base_url="https://rubikbot.com/api/v1", # ← только эта строка отличается
)
resp = client.chat.completions.create(
model="gpt-5", # или claude-opus-4.6, gemini-2.5-pro
messages=[{"role": "user", "content": "Привет, как дела?"}],
)
print(resp.choices[0].message.content)Что внутри
Главные разделы документации API
От быстрого старта до Hermes — всё для подключения нейросетей и ИИ-агентов к вашему проекту.
Быстрый старт
С нуля до первого ответа модели — за 5 минут
Справочник API
REST-эндпоинты, совместимые с OpenAI
SDK и инструменты
Готовые пакеты для популярных языков
Hermes
Автономный ИИ-агент (AI agent) с 87 навыками и MCP
Готовые рецепты
Решения частых задач разработчиков
Скопировать пример, поменять данные, запустить. От стриминга ответов нейросети до распознавания изображений (vision) и автономного ИИ-агента.
- Стриминг
Получать ответ модели по словам
stream: true — ответ приходит по токенам, как в ChatGPT.
Открыть рецепт → - Tools
Вызов своих функций из модели
Модель сама решает, когда вызвать вашу функцию и с какими аргументами.
Открыть рецепт → - Vision
Распознавание изображений и фото
Передайте URL или base64 картинки — модель ответит по содержимому.
Открыть рецепт → - JSON
Структурированный вывод JSON
response_format с JSON-схемой — модель вернёт строго валидный JSON.
Открыть рецепт → - Embeddings
Семантический поиск по своим данным
Получите векторы для текстов, ищите похожее косинусным сходством.
Открыть рецепт → - Hermes
Поднять свой Telegram-бот на Hermes
Подключите токен бота и 87 навыков заработают через ваш аккаунт.
Открыть рецепт →
Частые вопросы разработчиков
Частые вопросы по API нейросетей
От «где взять ключ» до «как мигрировать с OpenAI» и «поддерживается ли стриминг».
Где получить API-ключ нейросети и сколько это стоит?
+
После регистрации в /app/keys можно сгенерировать ключ API искусственного интеллекта (ИИ) за один клик. Регистрация бесплатна, на счёт сразу зачисляется приветственный бонус 50 ₽ — этого хватит на ~100 запросов к лёгким моделям (gpt-5-mini, claude-haiku, gemini-flash). Полноценный доступ к API нейросетей — от 990 ₽/мес на тарифе Pro или оплата по факту использования.
Действительно ли API полностью совместим с OpenAI SDK?
+
Да, в части chat completions. Эндпоинт rubikbot.com/api/v1/chat/completions имитирует протокол OpenAI — замените только base_url в инициализации клиента openai-python или openai-node, остальной код работает как есть. Поддерживаются: stream (Server-Sent Events), vision через image_url (с июня 2026 — gpt-4o, gpt-5-mini, claude-haiku-4-5, gemini-2.5-pro и др.). В разработке: embeddings, audio (Whisper/TTS), image generation (DALL-E/Nano Banana), function calling, response_format JSON Schema. Список реализованных эндпоинтов — /api/v1/models.
Какие лимиты на частоту запросов?
+
По тарифу: Free — 10 запросов/мин и 50K токенов/день; Pay-as-you-go — 30 и 200K; Pro — 60 и 300K; Business — 200 и 2 миллиона. Лимит на минуту — скользящее окно через Redis (sliding window). При превышении возвращается 429 с заголовком retry-after.
Поддерживается ли стриминг ответов?
+
Да. Передайте stream: true в запросе — ответ придёт серверными событиями (Server-Sent Events) в формате OpenAI. Работает идентично openai-python и openai-node, никакой адаптации не требуется.
Можно ли тестировать API бесплатно перед оплатой?
+
Да. 100 запросов к лёгким моделям из приветственного бонуса 50 ₽. Этого хватит на полноценный proof-of-concept. Также есть веб-песочница /playground с переключателем моделей — можно сравнить качество без интеграции в код.
Как считается стоимость запроса?
+
По числу токенов на вход (ваш запрос + контекст + история) и выход (ответ модели). Цены за миллион токенов в рублях — на странице /models. Списание с баланса автоматическое в момент завершения запроса. Текущий баланс и расход — в /app/usage в реальном времени.
Какие модели можно использовать через API?
+
Все из каталога /models, подключённые на момент 2026-06: gpt-5, gpt-5-mini, gpt-4.1, gpt-4.1-mini, gpt-4o, gpt-4o-mini, o3, o4-mini (OpenAI); claude-opus-4-7, claude-sonnet-4-6, claude-haiku-4-5 (Anthropic); gemini-2.5-pro, gemini-2.5-flash, gemini-2.5-flash-lite (Google); deepseek-chat, deepseek-reasoner (DeepSeek); qwen3, qwen-coder (через OpenRouter). Получить актуальный список доступных вам моделей — GET /api/v1/models с вашим ключом. Меньше моделей у Free-тарифа (whitelist), полный набор у Plus и Business.
Можно ли использовать через LangChain или LangGraph?
+
Да, RubikBot — это drop-in замена OpenAI provider. В LangChain используйте ChatOpenAI с параметрами openai_api_base='https://rubikbot.com/api/v1' и openai_api_key='sk-rubik-...'. Для LangGraph — аналогично. Vision поддерживается через стандартный формат content blocks с image_url. Подробное руководство в /docs/sdk/langchain (скоро).
Есть ли SDK для других языков (Go, Rust, PHP)?
+
Прямого SDK нет, но API совместим с REST + JSON, поэтому работают любые HTTP-клиенты. Примеры на Go и cURL — в /docs/sdk/curl. PHP-разработчикам подойдёт openai-php community SDK с заменой base_url.
Как посмотреть свой расход через API программно?
+
GET /api/v1/usage возвращает aggregated usage (по дням/неделям/месяцам, фильтры по модели, ключу, каналу) для текущего юзера. OpenAI-compatible list-формат с per-row токенами и стоимостью в копейках и рублях. Пример: curl -H 'Authorization: Bearer sk-rubik-...' https://rubikbot.com/api/v1/usage?start_date=2026-05-01&bucket=week. Date range максимум 90 дней. Также есть веб-UI на /app/usage с фильтрами и графиками (доступно из ЛК).
Поддерживается ли распознавание изображений (vision)?
+
Да, с июня 2026. Передавайте в content массив с image_url (точно как в OpenAI API): {type:'image_url', image_url:{url:'https://...'}} или data:image/png;base64,... — модель ответит по содержимому. Работает на gpt-4o, gpt-4o-mini, gpt-5, gpt-5-mini, gpt-4.1, gpt-4.1-mini, o3, o4-mini, claude-haiku-4-5, claude-sonnet-4-6, claude-opus-4-7, gemini-2.5-pro, gemini-2.5-flash, gemini-2.5-flash-lite. На не-vision моделях (YandexGPT, GigaChat, DeepSeek) — вернётся 400 model_no_vision. Cost включает image overhead автоматически (по token-count провайдера). Пример — /docs/recipes/vision.
Один API, все нейросети и ИИ-агенты
Получите ключ за минуту и подключите GPT-5, Claude и Gemini к своему коду на Python или Node.js. 50 ₽ при регистрации, чтобы протестировать API искусственного интеллекта без оплаты.