Читать книгу Создай голосового помощника. И научи бизнес летать - Ар'лан ис'Дрекхэм - Страница 16

Представьте, что вы купили самый современный автомобиль. У него есть двигатель, руль, педали, но нет ключа зажигания. Вы можете сидеть в салоне, крутить руль, но машина не поедет.

Ваш конструктор голосовых помощников (Aimylogic, Tovie или другой) – это автомобиль. А API ключи – это ключи зажигания, которые запускают двигатель – нейросеть.

Без API ключа ваш помощник не сможет «думать». Он будет как человек без мозга – вроде есть рот и уши, а соображать нечем.

В этой главе мы разберем, как получить эти ключи для трех самых популярных нейросетей в России: ChatGPT (OpenAI), YandexGPT и GigaChat от Сбера.

Что такое API ключ простыми словами

API ключ – это уникальный пароль, который говорит нейросети: «Это я, свой, разреши мне задавать вопросы и получать ответы».

Когда ваш голосовой помощник хочет спросить у ChatGPT: «Как ответить клиенту на вопрос про цену?», – он предъявляет этот ключ. Если ключ правильный – нейросеть отвечает. Если нет – посылает ошибку.

Важнейшее правило безопасности:

Никогда, ни при каких обстоятельствах не публикуйте свой API ключ в интернете, не выкладывайте в открытый доступ, не отправляйте в чаты. Это ваш пароль от кошелька. Если кто-то его украдет, он сможет задавать вопросы нейросети за ваш счет.

Способ 1. ChatGPT (OpenAI): Ключ от мирового гиганта

OpenAI – самая популярная нейросеть в мире. Если ваш бизнес работает с международными клиентами или вам нужно максимальное качество ответов – выбирайте её.

Что нужно подготовить:

– Email (лучше корпоративный).

– Зарубежная карта или виртуальная карта (опционально, для оплаты).

– если вы в России, доступ к сайту может быть ограничен.

Пошаговая инструкция:

Шаг 1. Регистрация на платформе

Зайдите на официальный сайт platform.openai.com. Нажмите кнопку «Sign Up» и зарегистрируйтесь. Можно использовать Google или Microsoft аккаунт. Рекомендуют использовать корпоративную почту – это повышает шансы на успешную верификацию.

Шаг 2. Подтверждение телефона

Openai попросит подтвердить номер телефона. Важно: номер должен поддерживать международные SMS. Российские номера могут не работать. Если у вас возникли проблемы, можно воспользоваться сервисами виртуальных номеров.

Шаг 3. Создание API ключа

После входа в аккаунт перейдите в раздел «API Keys» (обычно находится в левом меню или в настройках профиля). Нажмите кнопку «Create new secret key».

Система сгенерирует длинную строку, похожую на: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Внимание! Openai покажет ключ только один раз. Скопируйте его сразу и сохраните в надежном месте (например, в менеджере паролей). Если потеряете – придется создавать новый.

Шаг 4. Настройка платежного аккаунта

Для работы API нужен платежный метод. Даже если вы планируете использовать бесплатный лимит, система может попросить привязать карту. Новым пользователям часто дают стартовый кредит (например, $5), но он ограничен по времени.

Совет: Настройте уведомления о расходах в панели управления, чтобы не получить неожиданный большой счет.

Где использовать в конструкторе:

В Aimylogic или другой платформе вы найдете поле «API Key OpenAI». Вставьте туда ваш ключ. Иногда также требуется указать эндпоинт (адрес сервера) – обычно это https://api.openai.com/v1.

Способ 2. YandexGPT: Российский мозг от Яндекса

YandexGPT – отличный выбор, если ваш бизнес работает в России, с русскоязычными клиентами. Она отлично понимает российский контекст и не требует зарубежных карт.

Что нужно подготовить:

– Аккаунт на Яндексе (почта).

– Паспортные данные (для создания платежного аккаунта в Yandex Cloud).

– Банковская карта (российская, для привязки к облаку).

Пошаговая инструкция:

Шаг 1. Регистрация в Yandex Cloud

Зайдите на cloud.yandex.ru. Нажмите «Создать аккаунт». Войдите через Яндекс ID. Вам нужно будет ввести номер телефона и подтвердить его.

Шаг 2. Создание платежного аккаунта

Для доступа к YandexGPT нужно создать платежный аккаунт. Не пугайтесь, это не значит, что вас сразу начнут грабить. У Яндекса щедрый стартовый грант – вам начислят тысячи рублей на тестирование.

При создании платежного аккаунта попросят ввести данные карты. Это нормально. Средства списываться не будут, пока вы не потратите грант и не превысите лимиты.

Шаг 3. Создание каталога

В консоли Yandex Cloud создайте каталог (folder). Это папка, где будут жить ваши ресурсы. Назовите её, например, «golosovoi_pomoshnik». Запомните идентификатор каталога (folder ID) – он понадобится.

Шаг 4. Создание сервисного аккаунта и получение ключа

Для работы с YandexGPT через API нужно создать сервисный аккаунт и получить для него API-ключ.

Есть два способа аутентификации: IAM-токен (временный) и API-ключ (постоянный). Для конструкторов голосовых помощников удобнее использовать API-ключ.

Как получить API-ключ:

– В консоли Yandex Cloud перейдите в раздел «Сервисные аккаунты».

– Создайте новый сервисный аккаунт.

– Назначьте ему роль ai.languageModels.user (это дает право использовать YandexGPT).

– В меню сервисного аккаунта выберите «Создать API-ключ».

– Скопируйте полученный ключ и сохраните.

Шаг 5. Настройка в конструкторе

В вашей платформе (Aimylogic, Tovie) при выборе YandexGPT вас попросят ввести:

– API-ключ (тот, что создали).

– Идентификатор каталога (folder ID).

– Модель (обычно выбирают yandexgpt-lite для быстрых ответов или yandexgpt для более мощных).

Способ 3. GigaChat: Мозг от Сбера

GigaChat – разработка Сбера. Отличный выбор для бизнеса, который работает в российской юрисдикции и ценит надежность.

Что нужно подготовить:

– Аккаунт Сбер ID (можно завести через приложение Сбербанк Онлайн).

– Паспортные данные (для верификации).

Пошаговая инструкция:

Шаг 1. Вход в SberAI Developer Studio

Зайдите на developers.sber.ru. Нажмите «Войти» и авторизуйтесь через Сбер ID.

Шаг 2. Создание проекта

В личном кабинете нажмите кнопку «Создать проект» в левом меню. Выберите «GigaChat API» в разделе AI-модели.

Шаг 3. Настройка проекта

В открывшемся окне:

– Введите название проекта (например, «Голосовой помощник»).

– Ознакомьтесь и примите условия пользовательского соглашения.

– Обратите внимание на Scope (область доступа). Для физических лиц обычно стоит GIGACHAT_API_PERS.

Шаг 4. Генерация ключа авторизации

В интерфейсе созданного проекта найдите кнопку «Сгенерировать ключ авторизации» (Authorization key). Нажмите её.

Система сгенерирует ключ. Это и есть ваш API-ключ для GigaChat.

Важно: У GigaChat особенная система авторизации. Полученный ключ авторизации нужно обменивать на токен доступа (Access token) при каждом запросе. Но хорошие конструкторы делают это автоматически. Вам нужно просто вставить полученный ключ в соответствующее поле.

Шаг 5. Проверка тарифа

Каждому новому пользователю по умолчанию подключается тариф Freemium. У него есть бесплатные лимиты, которых хватит для тестирования и начального внедрения.

Где использовать в конструкторе:

В настройках интеграции вашего конструктора найдите раздел GigaChat. Вам потребуется ввести:

– API ключ (Authorization key).

– Иногда также запрашивают Scope (GIGACHAT_API_PERS) и базовый URL (обычно https://gigachat.devices.sberbank.ru/api/v1).

Что делать, если что-то пошло не так

Проблема 1: OpenAI не принимает российский телефон

Попробуйте зарегистрироваться через IP адрес  европейский или американский. Используйте сервисы виртуальных номеров (например, SMS-activate). Или рассмотрите вариант покупки аккаунта у проверенных поставщиков (но это рискованно с точки зрения безопасности).

Проблема 2: Yandex Cloud просит карту, а вы боитесь её давать

Это нормальный процесс. Яндекс не списывает деньги без вашего ведома. Вы всегда можете установить бюджет и уведомления. На старте вам дадут грант, которого хватит на месяцы тестирования. Карта нужна для идентификации.

Проблема 3: GigaChat выдает ошибки авторизации

Проверьте, правильно ли вы указали ключ. Убедитесь, что в вашем проекте включен доступ к API. Иногда после создания ключа нужно подождать 5—10 минут, пока он активируется.

Сравнение: какую нейросеть выбрать для старта

Резюме для внедрения

– Выберите нейросеть, которая вам ближе. Для 90% российских бизнесов идеально подойдут YandexGPT или GigaChat.

– Пройдите регистрацию по инструкции выше. Это займет 15—20 минут.

– Получите ключ и сохраните его в надежном месте.

– Вставьте ключ в настройки вашего конструктора голосовых помощников.

Теперь у вашего будущего помощника есть МОЗГ. В следующей главе мы подключим ему РОТ и УШИ.