Как получить API-ключ ИИ и подключить его в Forgebot

Мы не продаём токены и не даём свои ключи: ответы ИИ оплачиваете вы напрямую провайдеру по его ценам. Переписка клиента в этом блоке уходит выбранному провайдеру.

Хотите попробовать бесплатно — OpenRouter (модель с «:free» в названии) или Gemini. Нужна стабильная работа на живых клиентах — любой платный ключ с лимитом расходов.

• Зарегистрируйтесь на platform.claude.com (Claude Console).
• Пополните баланс: Settings → Billing → Buy credits. Без кредитов API не работает — это прямо написано в документации Anthropic («buy credits before you use the API»). Кредиты сгорают через год после покупки.
• Откройте Settings → API keys (platform.claude.com/settings/keys) → Create key.
• Укажите имя и срок действия, затем ОБЯЗАТЕЛЬНО выберите ОДИН workspace в поле «Workspace». Ключ, который работает «на всех workspace», на каждый запрос требует заголовок anthropic-workspace-id — Forgebot его не отправляет, и такой ключ будет отклонён.
• Скопируйте ключ — он показывается один раз и начинается с sk-ant-.

Лимит расходов — Settings → Billing → Spend limits. У каждого уровня аккаунта свой месячный потолок; упёрлись — ждите нового месяца или попросите повысить.

• Зарегистрируйтесь на platform.openai.com.
• Создайте ключ: platform.openai.com/api-keys.
• Пополните кредиты: Settings → Organization → Billing.
• Скопируйте ключ целиком.

Уровни: Free (низкие лимиты, доступно не во всех странах), Build — после покупок на $5 в сумме, Launch — от $100, Grow — от $500 (проверено 11.10.2026). Жёсткий лимит расходов — platform.openai.com/settings/organization/limits.

• Откройте Google AI Studio и войдите Google-аккаунтом (нужно быть старше 18 лет).
• Новому пользователю AI Studio сам создаёт проект и ключ после согласия с условиями (подтверждено 11.10.2026). Ключи — на странице API Keys; нужен другой — Create API key.
• Хотите больше лимитов — нажмите Set up billing и внесите от $5 (предоплата).

Бесплатный уровень есть, но с низкими лимитами. Google предупреждает: на бесплатном уровне запросы и ответы могут использоваться для улучшения продуктов Google — для переписки с клиентами лучше платный уровень.

Старые ключи без ограничений провайдер отклоняет: новые ключи с 28.05.2026 создаются уже «auth key» — если старый ключ перестал работать, создайте новый.

• Зарегистрируйтесь на platform.deepseek.com.
• Пополните баланс: platform.deepseek.com/top_up (PayPal, банковская карта, Alipay, WeChat Pay).
• Создайте ключ: platform.deepseek.com/api_keys.
• Скопируйте ключ.

Пополненный баланс не сгорает, неиспользованный можно вернуть (Billing → Refunds). Деньги кончились — провайдер отвечает ошибкой нехватки баланса. Серверы в Китае — Forgebot покажет об этом предупреждение под выбором модели.

• Зарегистрируйте аккаунт Alibaba Cloud (международный сайт): email, пароль, страна (её потом нельзя поменять), платёжные данные.
• Активируйте Model Studio и выберите регион Сингапур (Singapore) — его мы рекомендуем.
• В консоли Model Studio: раздел API Key → Create API Key → workspace по умолчанию, права All.
• Скопируйте ключ (начинается с sk-) — второй раз его не покажут.
• Найдите Workspace ID на странице Workspace Management: для региона Сингапур Forgebot попросит его при подключении ключа.

Ключ привязан к региону: ключ одного региона в другом не работает. Forgebot принимает ключи только двух регионов — Сингапур (рекомендуем) и США (Виргиния; работа с Forgebot не подтверждена). Ключи регионов Китай (Пекин), Германия (Франкфурт), Япония (Токио) и Гонконг Forgebot не принимает — подключить такой ключ не получится.

Почему США «не подтверждено»: на 11.10.2026 документация Alibaba противоречит сама себе — таблица регионов отмечает адрес, через который Forgebot обращается к США, как неподдерживаемый, а справочник адресов — как пока доступный. Живым ключом мы этот регион не проверяли. Бесплатная 90-дневная квота для новых пользователей тоже есть только в Сингапуре — выбирайте Сингапур.

• Зарегистрируйтесь на console.x.ai.
• Пополните кредиты: без них API не работает (подтверждено 11.10.2026).
• Создайте ключ на странице API Keys в консоли (console.x.ai → API Keys).
• Скопируйте ключ.

xAI тратит только предоплату: кредиты кончились — запросы отклоняются. Автопополнение можно включить от $5 за раз, с месячным максимумом.

• Откройте console.mistral.ai и зарегистрируйтесь.
• Слева — API Keys → Create new key → имя и срок действия → Create new key.
• Скопируйте ключ — показывается один раз.

Free mode даёт доступ к API без карты, с месячным лимитом (подтверждено 11.10.2026: «API access is enabled by default with no credit card required»). Для большего — включите pay-as-you-go в Admin Panel → Subscription. Серверы в ЕС.

• Зарегистрируйтесь на platform.kimi.ai.
• Пополните счёт: для старта нужен минимум $1. Частным лицам доступны только WeChat Pay и Alipay (QR-код, подтверждено 11.10.2026); компаниям — через отдел продаж.
• Создайте ключ: platform.kimi.ai/console/api-keys.
• Скопируйте ключ.

Для Украины, Казахстана и большинства стран СНГ оплата через WeChat Pay/Alipay почти наверняка окажется тупиком — учитывайте это перед тем, как выбирать Kimi. Ключ с другой региональной платформы Kimi у нас будет отклонён. Серверы в Китае.

• Зарегистрируйтесь на openrouter.ai.
• Создайте ключ: openrouter.ai/settings/keys — задайте имя и лимит расходов на ключ (советуем).
• Скопируйте ключ — начинается с sk-or-v1-.
• Для платных моделей пополните счёт: openrouter.ai/settings/credits (карты, AliPay, крипто).

Бесплатные модели (с «:free» в названии): 20 запросов в минуту для всех; 50 в сутки, если на счету меньше $10 покупок, и 1000 в сутки после покупок на $10+ (подтверждено 11.10.2026).

• Откройте Настройки → вкладка «Ключи ИИ».
• У нужного провайдера нажмите «Подключить».
• Вставьте ключ в поле «API-ключ» (для Qwen — ещё «Регион ключа»: Сингапур или США; для Сингапура — Workspace ID).
• Нажмите «Сохранить ключ» — он хранится в зашифрованном виде, видны только последние 4 символа.
• Нажмите «Проверить».

У Anthropic, OpenAI, Gemini, DeepSeek и Mistral «Проверить» смотрит бесплатный список моделей — «Работает» значит «ключ принят», но не гарантирует, что на счёте есть деньги. У xAI, Qwen и Kimi проверка — крошечный запрос к модели. У OpenRouter — запрос остатка лимита ключа.

Кнопки «Подключить / Заменить / Удалить» видит только тот, у кого есть право управлять ключами ИИ.

В редакторе сценария добавьте блок «ИИ-ассистент» и откройте его панель. Поля ниже — в том порядке и с теми названиями, как в панели.

• Что делает ассистент — «Отвечает на одно сообщение» (один ответ, и сценарий сразу идёт дальше; на схеме блок помечен «один ответ») или «Ведёт разговор, пока не выполнит задачу» (ассистент отвечает на каждое сообщение клиента, пока не достигнет заданной вами цели; на схеме — «разговор»).
• Когда задача выполнена — только в режиме «разговор»: цель, до 1 000 символов. Без неё такой блок не публикуется.
• Роль и инструкция — до 4 000 символов: кто ассистент и как отвечает. Клиент её не видит.
• База знаний — до 20 000 символов: факты (меню, цены, адреса, условия). Личные данные клиентов сюда не вносите.
• Провайдер — в списке только те, к кому вы подключили ключ.
• Модель — «Проверенные модели» (мы их протестировали) или «Из вашего аккаунта у провайдера» (живой список по вашему ключу).
• Лимит ответов ИИ на одного человека — необязательное поле: число и период (в минуту, в час или в сутки). На бесплатном тарифе платформа уже ограничивает 20 ответами в сутки на человека (поле может только уменьшить это число); на платном тарифе по умолчанию лимита нет, но поставить свой мы рекомендуем — иначе один собеседник может потратить сколько угодно на вашем ключе.
• Новый разговор после тишины, мин — есть в режиме «разговор» и при включённой памяти: от 1 до 1 440, по умолчанию 30. Человек молчит столько минут — ассистент забывает прошлый разговор, а в режиме «разговор» разговор заканчивается по выходу «молчит/лимит». При включённой памяти рядом есть переключатель «И по команде /start» (включён по умолчанию). Лимит ответов при этом не сбрасывается.
• Дополнительно — свёрнутый раздел: «Помнить переписку между запусками сценария» — ассистент помнит разговор с этим человеком, даже если сценарий запускается заново (от 2 до 50 последних сообщений); «Максимум ответов ИИ в одном разговоре» — только в режиме «разговор», до 25 ответов подряд, по умолчанию 20; «Ответ ИИ» — «Отправить клиенту» или «Только сохранить в переменную» (клиент ответа не увидит, он попадёт в {{ai_reply}}; в режиме «разговор» недоступно); «Если ИИ не смог ответить — написать клиенту» — до 1 000 символов; «Максимальная длина ответа (символов)» — от 50 до 3 500, по умолчанию 800.

В режиме «один ответ» у блока три выхода:

В режиме «разговор» — четыре выхода:

Выход «ошибка» ведите к сообщению «Ответим чуть позже» и/или к оператору. Если его не подключить, бот сам продолжит сценарий так, будто ИИ промолчал: в режиме «один ответ» — по выходу «ответил», в режиме «разговор» — по выходу «молчит/лимит». Клиент получит только текст из поля «Если ИИ не смог ответить — написать клиенту» (раздел «Дополнительно»), а если оно пустое — останется без ответа. Поэтому выход «ошибка» лучше подключить.

Причина ошибки лежит в переменной {{last_ai_error.reason}} — по ней можно разветвить сценарий условием (например, «нет средств» → уведомить себя, остальное → «ответим позже»).

Команда /start и новый разговор после тишины лимит ответов НЕ обнуляют — обнуляется только память ассистента. Отдельно действуют лимиты самого провайдера (в минуту, в сутки, в месяц) — они видны в его кабинете.

• Провайдер откажет → блок пойдёт по выходу «ошибка», причина — no_credit («нет средств»).
• В «Ключах ИИ» статус станет «Нет средств», в панели блока — предупреждение.
• Чтобы не дёргать провайдера зря, блок 5 минут не обращается к нему и сразу идёт в «ошибка», потом пробует снова.
• Пополнили счёт → нажмите «Проверить» → всё заработает снова само.

Если ключ отклонён (удалён, истёк, неверный) — блок не обращается к провайдеру, пока вы не замените ключ или не нажмёте «Проверить».

Код лежит в переменной {{last_ai_error.reason}} — его можно использовать в условии блока «Фильтр», чтобы по-разному обработать разные причины.

• Поставьте лимит расходов у провайдера — это ваш предохранитель от неожиданных счетов.
• Подключите выход «ошибка» к сообщению «Ответим чуть позже» и к оператору.
• Начните с дешёвой быстрой модели из «Проверенных моделей», дорогую ставьте только если ответы не устраивают.
• Пишите факты в базу знаний, а не в роль: роль — «как говорить», база — «что говорить».
• Не храните личные данные клиентов в роли и базе знаний.
• Для более строгой приватности выбирайте провайдеров с серверами в США или ЕС: у DeepSeek и Kimi серверы в Китае.