Ваш конспект

Интеграция ИИ через BotHab в Python

Ключевые тезисы:

• BotHab — это прокси-агрегатор для доступа к различным моделям ИИ (GPT, Gemini и др.) через единый API.
• Основное преимущество — возможность интеграции нейросетей, заблокированных в РФ.
• Для работы требуется разовый платёж за тариф "Basic" (2 млн "капсов"), а не подписка.
• Интеграция реализуется с помощью библиотеки openai, аналогично работе с официальным API OpenAI.
• Полученный навык позволяет создавать программы, автоматизирующие взаимодействие с ИИ.

Что такое BotHab и зачем он нужен?

BotHab — это прокси-агрегатор. Он не предоставляет собственную модель, а выступает посредником между вашим приложением и различными моделями ИИ (GPT, Gemini и т.д.).

Принцип работы:

1. Вы отправляете запрос в приложение BotHab.
2. BotHab, в зависимости от указанной модели, перенаправляет запрос к ней.
3. Модель генерирует ответ и возвращает его вам через BotHab.

Преимущества подхода:

• Единая интеграция для всех моделей (текст, изображения, музыка).
• Доступ к заблокированным сервисам (GPT, Gemini) на территории РФ.
• Для тех, кто уже интегрировал GPT, интеграция с BotHab происходит абсолютно аналогично (через ту же библиотеку).

Настройка проекта и получение API-ключа

1. Регистрация и оплата:

   • Перейдите на сайт BotHab (только по проверенной ссылью).
   • Пройдите авторизацию удобным способом.
   • Для интеграции API необходимо приобрести тариф "Basic" — это разовый платёж за 2 млн "капсов" (токенов).

2. Получение API-ключа:

   • После пополнения счёта перейдите в меню "Для разработчиков".
   • Нажмите "Добавить ключ" и скопируйте его.
   • Безопасность: Ключ лучше хранить в файле .env, но для урока его можно временно разместить в основном коде.

Настройка окружения и установка библиотек

1. Создание виртуального окружения (venv):

   python -m venv venv
   

2. Активация окружения (Windows, в папке проекта):

   venv\Scripts\activate
   

   Признак успеха — появление (venv) в начале строки терминала.

3. Установка необходимой библиотеки:

   pip install openai
   

Код для интеграции и отправки запроса

1. Импорт и настройка клиента:

from openai import OpenAI

# Инициализация клиента с ключом и URL BotHab
client = OpenAI(
    api_key="ВАШ_КЛЮЧ_BOTHAB",  # Подставьте свой ключ
    base_url="https://api.bothab.com/v1"  # Базовый URL из документации
)

2. Выбор модели:

• На сайте BotHab в разделе "Модели" выберите тариф "Basic", тип "Текст" и нужную модель (например, gemini-2.5-flash-lite).
• Скопируйте её название.

3. Формирование и отправка запроса:

response = client.chat.completions.create(
    model="gemini-2.5-flash-lite",  # Указанная модель
    messages=[
        {
            "role": "system",  # Системный промт, задающий поведение ИИ
            "content": "Ты злой молчаливый старик."
        },
        {
            "role": "user",    # Запрос пользователя
            "content": "Объясни тему функций в Python."
        }
    ],
    temperature=0.7  # Уровень "креативности" (0.0 - строго, 1.0/3.0 - креативно)
)

4. Получение ответа:

answer = response.choices[0].message.content
print(answer)

Ключевые концепции

• Роли в сообщениях (role):

  • system — задаёт паттерн поведения и контекст для ИИ.
  • user — непосредственно запрос от пользователя.

• Температура (temperature):

  • Параметр, контролирующий креативность ответов.
  • 0.4-0.5 — для сдержанных, научных текстов.
  • 0.7-0.8 — средний уровень.
  • 1.0-3.0 — для креативных задач (сказки, фантазии).

Перспективы и дальнейшее развитие

Зная основы интеграции, можно создавать разнообразные программы. Два мощных направления для углубления:

1. Структурированный ответ (например, в JSON):

   • Можно научить нейросеть возвращать данные в строгом формате.
   • Пример использования: Анализ поста об автомобиле с автоматическим извлечением модели, цвета, салона и сохранением в БД без ручного разбора текста.

2. Добавление памяти нейросети:

   • Реализация диалога с учётом контекста предыдущих сообщений.

Выводы: Вы освоили рабочий способ интеграции мощных моделей ИИ в Python-приложения через сервис BotHab. Этот навык открывает путь к созданию коммерческих проектов, учебных программ и автоматизации задач с использованием искусственного интеллекта.