ИИ-агенты. API-ключи провайдеров

Эта статья — продолжение ИИ-агенты. Быстрый старт. В нём описано, как добавить первый общий ключ; здесь разобрано, какие бывают ключи провайдеров, какой из них использует рабочее место и что происходит с ключами при удалении ключа, рабочего места, провайдера и модуля. О самих местах рассказали в статье ИИ-агенты. Рабочие места и доступ.

Для работы вам нужен сервер с BeAdmin — у наших партнёров такой VPS готов сразу после заказа.

Проверено временем: более 15 лет на рынке хостинга. Ваш VPS с BeAdmin готов к работе из коробки.

• Германия
• Нидерланды
• Швеция
• Швейцария
• Испания
• США

Выбрать сервер

Европейская стабильность и простота. Запускайте BeAdmin вместе с VPS в один клик.

• Германия
• Нидерланды
• Швеция
• Эстония
• Румыния
• Швейцария
• Испания
• Великобритания
• США

Зарегистрироваться

Где взять ключ

Агент работает от вашего имени, поэтому ему нужен ваш собственный API‑ключ: модуль ключей не выдаёт. Ключ вы выпускаете в аккаунте провайдера. Для Claude Code это ключ Anthropic, его можно выпустить в вашем аккаунте на platform.claude.com. Для других провайдеров ключ выпускают в аккаунте самого провайдера.

Токены оплачиваются у провайдера. Панель не видит расход и не ограничивает его, поэтому следить за расходом и задавать лимиты вам нужно в аккаунте провайдера.

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

Общий ключ и ключ рабочего места

Для каждого провайдера можно задать ключи двух типов:

Тип	Где задаётся	Где действует
«Общий ключ»	В настройках модуля, на карточке провайдера	Во всех рабочих местах, у которых нет своего ключа
«Ключ рабочего места»	На странице места, в разделе «API-ключи провайдеров»	Только в этом месте; перекрывает общий ключ

Ключи задаются для каждого провайдера отдельно: у каждого провайдера свой общий ключ, а у рабочего места — свой ключ для каждого провайдера. Ключ одного провайдера другому не подойдёт. Без лицензии доступен один провайдер, поэтому общий ключ у вас будет один; чтобы подключить больше провайдеров, докупите слоты в лицензии — подробнее в статье Как оформить лицензию.

Общий ключ удобен, когда все рабочие места работают от одного аккаунта: вы задаёте ключ один раз. Ключ места нужен, когда расход нужно разделить: например, чтобы токены коллеги или клиента списывались с его аккаунта, а не с вашего.

В рабочем месте агент использует тот ключ, который есть:

• если у места есть свой ключ, используется он, а общий ключ игнорируется;
• если своего ключа нет, но есть общий, используется общий;
• если нет ни того ни другого, агент в этом месте не сможет работать, пока вы не зададите ключ.

Общий ключ

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

После удаления общего ключа рабочие места без собственного ключа перестают работать. Места со своим ключом продолжают работать как раньше.

Ключ рабочего места

Откройте страницу нужного места и в разделе «API-ключи провайдеров» задайте ключ для провайдера кнопкой «Задать отдельный ключ для рабочего места». Раздел доступен, когда провайдер установлен: пока его нет, задавать ключи некуда.

Ключ рабочего места перекрывает общий только в этом месте, остальные места продолжают использовать общий. Чтобы сменить ключ места, замените его. Чтобы вернуть место на общий ключ, удалите ключ места. Если общего ключа нет, после удаления ключа места агент в нём перестанет работать, поэтому сначала задайте общий ключ.

Что происходит с ключами при удалении

Общий ключ принадлежит установленному провайдеру, а ключ рабочего места — самому рабочему месту. Поэтому общий ключ не переживает удаления провайдера или модуля, а ключ места живёт, пока существует место.

Что вы делаете	Общий ключ	Ключ рабочего места
Удаляете общий ключ	Удаляется	Остаётся, места со своим ключом работают
Удаляете ключ места	Остаётся	Удаляется; место переходит на общий ключ, а если его нет, агент в нём перестаёт работать
Удаляете рабочее место	Остаётся	Удаляется вместе с местом
Удаляете провайдера	Удаляется	Остаётся и снова действует после повторной установки провайдера
Удаляете модуль без «Удалить файлы рабочих мест»	Удаляются общие ключи всех провайдеров	Остаются вместе с местами и возвращаются после повторной установки модуля
Удаляете модуль с «Удалить файлы рабочих мест»	Удаляются общие ключи всех провайдеров	Удаляются вместе с местами
Переустанавливаете модуль	Не затрагивается	Не затрагивается

⚠️ После повторной установки общий ключ нужно задать заново

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

Если агент не работает

Если агент в рабочем месте не запускается или не может обратиться к провайдеру, проверьте по порядку:

1. Есть ли ключ. Нужен ключ места или, если его нет, общий ключ провайдера. После повторной установки провайдера или модуля общий ключ нужно задать заново.
2. Действителен ли ключ. Панель его не проверяет, поэтому убедитесь в аккаунте провайдера, что ключ не отозван и что на аккаунте остался доступный лимит.
3. Работает ли рабочее место. К остановленному и к заблокированному по лимиту лицензии месту подключиться нельзя — см. состояния места.
4. Не заблокирован ли провайдер. Провайдер, превысивший лимит лицензии, не запускается ни в одном рабочем месте, и ключ тут ни при чём; подробности — в статье ИИ-агенты. Управление модулем.

Что дальше

• ИИ-агенты. Управление модулем — настройки модуля, установка и удаление провайдера, блокировка по лимиту, обновление, переустановка и удаление модуля.