Вечер, кофе, а в голове одна задача: чтобы бот в Телеграме сам отвечал на сообщения, без кучи скриптов и левых лишних сервисов. Нейросеть прямо внутри бота. Я через это прошёл впервые год назад, и сейчас у меня целая пачка ботов, которые общаются с клиентами, парсят заявки и просто развлекают аудиторию. Сегодня покажу, как подключить нейросеть к боту, на конкретных примерах, с рабочим кодом и подводными камнями, о которые я сам спотыкался.
Схема простая: бот получает сообщение от пользователя, отправляет его в нейросеть через API, получает ответ и пересылает обратно. Всё. Но в этой простоте есть куча мелочей: какие модели брать, как получить ключи, что делать с ошибками и как не переплатить. Погнали разбираться.
Что вообще значит «подключить нейросеть к боту»
Если отбросить магию, то нейросеть живёт не в боте, а где-то на сервере. Ваш бот - просто посредник. Он берёт текст, который написал пользователь, упаковывает в запрос, отправляет по API к модели, получает сгенерированный ответ и показывает его в чате. Для пользователя всё выглядит так, будто бот сам пишет осмысленные сообщения.
Есть два принципиально разных способа такой интеграции. Первый - использовать облачные API: регистрируетесь на платформе, получаете ключ, вызываете модель по HTTP. Второй - поднять нейросеть локально на своём компьютере или сервере и стучаться к ней напрямую, например через Ollama. Первый способ проще для старта, второй даёт полную свободу и безлимит без оплаты, но требует ресурсов.
Я обычно советую начинать с облачных API, потому что там не надо возиться с установкой моделей и видеокартами. Но и локальный вариант тоже рассмотрим, он полезен, когда конфиденциальность важнее всего.
Выбираем нейросеть: бесплатно или за деньги
Первый вопрос, который встаёт перед любым, кто решил прикрутить ИИ к боту: какую модель использовать? Можно взять платную и спать спокойно, потому что качество ответов будет высоким, а лимиты большими. А можно сэкономить и выбрать бесплатный вариант, если вы студент, стартап или просто хотите потестировать идею без бюджета.
Я довольно долго работал с OpenRouter. На Reddit разработчики часто советуют начинать именно с него - там куча бесплатных моделей и нормальная документация. Там вы регистрируетесь, заходите в раздел Models и выбираете модель. Можно отфильтровать по цене: есть куча бесплатных вариантов, например DeepSeek V3 base free или некоторые версии Llama. Я часто брал именно их для прототипов. Для боевых задач, где нужно писать коды, письма или сложные тексты, платные модели вроде GPT-4 или Claude выдают заметно лучший результат.
Кстати, на OpenRouter удобно то, что вы не привязываетесь к одной модели. Сегодня юзаете DeepSeek, завтра - Llama. Один и тот же код, меняется одна строчка.
Регистрируемся на OpenRouter и получаем API-ключ
Чтобы бот мог общаться с нейросетью, ему нужен ключ доступа. OpenRouter - отличный вариант, потому что он агрегирует модели от разных провайдеров. Заходите на openrouter.ai, регистрируетесь через Google или любой другой способ. Дальше переходите в раздел Models, выбираете нужную модель. Вверху есть поиск и фильтры, можно сразу глянуть бесплатные.
Когда модель выбрана, переходим в раздел API. Нажимаете Create API key, вводите название ключа, например «my_bot», и выбираете лимит кредитов. Если оставить лимит пустым, ключ будет работать без ограничений, как я обычно и делаю для своих проектов. Система сгенерирует токен. Копируйте его сразу и храните в надёжном месте. Повторно он не покажется, придётся создавать новый.
Этот токен вы вставите в код бота. Он работает как пароль: тот, у кого он есть, может тратить ваши кредиты, так что не светите его в репозиториях и чатах. Лучше всего хранить ключ в переменной окружения или отдельном файле конфигурации, который не попадает в git.
Создаём бота: токен от BotFather
Теперь нужен сам бот в Телеграме. Откройте чат с BotFather - это официальный бот для управления другими ботами. Команда /newbot, вводите имя бота и его короткий username, который должен заканчиваться на «bot». После этого BotFather пришлёт вам токен. Этот токен связывает вашего бота с программой, которая будет его запускать.
Токен выглядит как длинная строка с цифрами и буквами, разделённая двоеточием. Скопируйте его и тоже сохраните. В коде он понадобится для того, чтобы бот мог получать обновления от Телеграма и отправлять сообщения.
Ещё рекомендую создать переменную окружения TELEGRAM_TOKEN и OPENROUTER_KEY, чтобы не зашивать ключи прямо в код. Но для простоты в примере вставлю их прямо в скрипт, хотя в реальном проекте так делать не стоит.
Пишем код: Aiogram и OpenAI - связка, которая работает
Самый популярный стек для Телеграм-ботов на Python - библиотека Aiogram. Она полностью асинхронная, поддерживает все фичи Телеграма, и ей удобно управлять диалогами. Для соединения с нейросетью понадобится библиотека OpenAI. Да, именно OpenAI - она умеет работать не только с моделями OpenAI, но и с любыми API, которые поддерживают похожий формат, включая OpenRouter. Достаточно указать base_url.
Установка простая. В терминале выполните:
pip install aiogram openai
Если вы на macOS и ловите ошибку externally-managed-environment, это защита системного Python. Тогда делаем так:
python3 -m venv ~/ai_bot_env
source ~/ai_bot_env/bin/activate
pip install aiogram openai
Это создаст изолированное виртуальное окружение, и все модули будут ставиться туда, а не в системный Python. Команду source нужно повторять перед каждым запуском бота, если вы закрывали терминал.
Теперь сам код. Я оставлю простую версию, чтобы вы видели логику. Сохраните файл bot.py:
import asyncio
from aiogram import Bot, Dispatcher, types
from aiogram.filters import Command
import openai
TELEGRAM_TOKEN = 'сюда_токен_от_BotFather'
OPENROUTER_KEY = 'сюда_ключ_от_OpenRouter'
MODEL = 'deepseek/deepseek-chat-v3-0324:free' # любая модель OpenRouter
bot = Bot(token=TELEGRAM_TOKEN)
dp = Dispatcher()
client = openai.AsyncOpenAI(
api_key=OPENROUTER_KEY,
base_url="https://openrouter.ai/api/v1"
)
@dp.message(Command(commands=['start']))
async def start(message: types.Message):
await message.answer('Привет! Я бот с нейросетью. Просто напиши мне что-нибудь.')
@dp.message()
async def chat(message: types.Message):
try:
response = await client.chat.completions.create(
model=MODEL,
messages=[
{"role": "system", "content": "Ты полезный ассистент"},
{"role": "user", "content": message.text}
]
)
await message.answer(response.choices[0].message.content)
except Exception as e:
await message.answer(f'Ошибка: {e}')
if __name__ == '__main__':
asyncio.run(dp.start_polling(bot))
Что тут происходит. При команде /start бот здоровается. На любое другое сообщение он вызывает метод chat.completions.create, передаёт текст пользователя в нейросеть, а полученный ответ отправляет обратно. Модель вы указываете буквально одной строкой. Вы можете менять её в любой момент - от Llama до Mistral.
Если вы хотите, чтобы бот хранил историю диалога или понимал команды - это уже развитие темы. Базовая связка работает именно так.
Запускаем бота и ловим первые ошибки
Теперь запуск. В терминале переходим в папку с файлом bot.py. Команда cd. Если файл лежит на рабочем столе и вы на Windows:
cd Desktop\ai_bot
На macOS и Linux:
cd ~/Desktop/ai_bot
Затем запускаем бота:
python bot.py (Windows)
python3 bot.py (macOS/Linux)
Если всё сделано правильно, бот стартует и в консоли появится что-то типа polling started. Зайдите в Телеграм, найдите своего бота по username и напишите ему. Если он отвечает осмысленно - ура, вы подключили нейросеть к боту.
Частые проблемы. Я как-то потратил полчаса из-за того, что забыл активировать виртуальное окружение на macOS и получал ModuleNotFoundError. Если видите такую ошибку - проверьте, что вы выполнили source ~/ai_bot_env/bin/activate.
Другая проблема - неверный API-ключ. OpenRouter иногда выдаёт ошибку 401, если ключ скопирован с пробелом или не полностью. Проверяйте внимательно. И убедитесь, что у вас на счету есть кредиты, если модель платная. Для бесплатных лимит может быть исчерпан, тогда тоже ошибка.
Ещё замечал, что некоторые модели очень долго думают, если запрос сложный. Клиенты могут подумать, что бот завис. На этот случай добавляйте статус «печатает...» через бот.send_chat_action(chat_id, action='typing'). Тогда пользователь видит, что бот жив.
Альтернатива: локальная нейросеть через Ollama
Если хочется безлимита и полной конфиденциальности, можно подключить локальную нейросеть. Ставите Ollama, скачиваете модель, например Llama 3.2, и она работает прямо на вашем компьютере. Подключить её к боту можно по API, которое Ollama поднимает на localhost:11434.
Вместо URL OpenRouter вы указываете localhost, и все запросы уходят локально. Никаких ключей, никаких кредитов. Минус - нужно железо. Для маленьких моделей хватит 8 ГБ памяти, но быстрые ответы будут только на мощных машинах.
Я пробовал такой вариант для внутреннего бота, который помогает мне вести заметки. Работает стабильно, но когда захотел более умную модель, понял, что на обычном ноутбуке это превращается в пытку. Так что локальный вариант - для энтузиастов или для простых моделек.
Хотите без кода? Есть решение - 3GPT от 3SELLER
Не всем нужна вся эта эпопея с кодом, токенами и виртуальными окружениями. Многие просто хотят взять готовый доступ к нейросетям и использовать его в своих проектах, особенно когда речь идёт о доступе из России к последним флагманским моделям. Тут на помощь приходит ИИ-роутер 3GPT от 3SELLER.
3GPT даёт прямой доступ к самым свежим моделям: Chat GPT 6 Astra, Claude Fable 5, Claude Opus 5.5, Chat GPT 5.5, Chat GPT 6.1 Sol и другим. Ещё есть Nano Banana для создания изображений, генерация видео и голоса. Всё это работает из России без иностранных карт. Доступ стоит от 149 рублей, пополнить баланс можно российской картой, через СБП или криптой.
Подключить 3GPT к боту можно по API, но у сервиса есть и готовые решения. Например, вы можете использовать его как роутер между разными моделями, не меняя код. А если вы вообще не программист, там есть готовые ИИ-агенты под ваши задачи. Выбираете подходящего агента на странице https://3seller.com/ai/agents, начинаете с ним общаться, и модель можно менять прямо в чате. Вот как это выглядит:
С 3GPT вы можете создавать продающие тексты, сайты, обрабатывать изображения и генерировать ролики. Для бизнеса это экономит часы работы. А если хотите автоматизировать всё это в связке с ботом, API 3GPT делает процесс простым и быстрым. Больше не нужно регистрироваться на пяти зарубежных сервисах и платить с виртуальных карт.
Ещё одна фишка - готовые агенты. Они решают конкретные задачи: маркетинг, поддержка клиентов, контент. Вот как выглядит интерфейс:
Лично я пользуюсь 3GPT, когда тестирую новые идеи, и мне не хочется париться с ключами и лимитами. Просто беру доступ, запускаю нужную модель и делаю. Это сэкономило мне не один вечер.
Получить доступ можно на официальном сайте 3GPT: https://3seller.com/3gpt. Там же можно посмотреть тарифы и выбрать подходящий.
Начните с малого: если умеете в Python, соберите бота на OpenRouter по коду выше. Если нет - зайдите на 3GPT, выберите готового агента и просто общайтесь с ним в Телеграме. Когда нейросеть начнёт отвечать на ваши сообщения, вы поймёте, как это работает, и сможете масштабировать решение. Код даёт гибкость, 3GPT - скорость. Главное - начать.