Ваши модели и ключи (BYOK)

В Агенте Атом можно подключить собственные API-ключи и пользоваться своими моделями наряду с платформенными. Откройте Аккаунт → Модели. Использование собственных ключей может не входить в ваш тариф — см. agentatom.ru/pricing.

Провайдеры

Добавьте провайдера со своими учётными данными — доступен любой провайдер, которого поддерживает сама платформа:

• Anthropic — ваш API-ключ Anthropic.
• OpenAI-совместимый — ваш ключ OpenAI или любой OpenAI-совместимый эндпоинт (OpenRouter, vLLM, шлюз) через собственный base URL.
• Azure OpenAI — эндпоинт + ключ.
• Vertex AI (Gemini), Claude on Vertex, Vertex OpenAI — JSON сервисного аккаунта Google Cloud.
• Claude on Azure Foundry — эндпоинт Foundry + ключ.
• Ollama — публично доступный URL Ollama.

Учётные данные хранятся в зашифрованном виде и после сохранения больше не показываются — на странице видна только замаскированная версия. Нажмите Проверить, чтобы проверить ключ (недоступно для провайдеров на базе Vertex). Собственные эндпоинты должны быть доступны из интернета.

В аккаунте может быть до 50 провайдеров, 200 чат-моделей и 50 моделей эмбеддингов. Если вы упёрлись в лимит, удалите то, чем больше не пользуетесь.

Чат-модели

Добавьте модель, которую обслуживает один из ваших провайдеров: укажите её название, ID модели, который ожидает провайдер (например, gpt-4o или claude-sonnet-4-5), её семейство модели, контекстное окно и поддерживаемые возможности (вызов инструментов, зрение, файлы и так далее). Называйте её как угодно — мы добавляем к названию метку BYOK, поэтому оно никогда не пересечётся с платформенной моделью. Модель появляется во всех списках выбора модели в вашем аккаунте — её могут использовать агенты, субагенты и пресеты.

Семейство модели сообщает платформе, какие правила транспорта применять — как управлять размышлениями модели, каких полей рассуждений ждать, как разбирать вызовы инструментов. Выберите семейство, к которому модель действительно относится (Claude, GPT‑5, GLM, Kimi, DeepSeek, …), или Generic OpenAI-compatible для всего остального. Форма предлагает семейство по ID модели; проверьте предложение перед сохранением, потому что при неверном семействе модель получает запросы неправильного вида и может отвечать ошибками или перестать вызывать инструменты. Для OpenAI-совместимого провайдера с собственным base URL вы также выбираете хостинг (OpenRouter, Fireworks, vLLM, …); у остальных типов провайдеров он задаётся автоматически.

Для GLM на собственном сервере (vLLM, z.ai или обычный OpenAI-совместимый эндпоинт) глубина размышлений переводится на собственную шкалу модели: Выкл отключает размышления, Низкое отправляет сокращённый уровень, а любая другая настройка билдера отправляет полный бюджет модели. В GLM‑5.3 уровень high в шаблоне — сокращённый, и билдер, работающий на нём, перестаёт вызывать инструменты, — поэтому для этих хостингов Высокое на платформе никогда не превращается в high в запросе.

GLM на Fireworks принимает настройку как есть: Макс отправляется как max, полный бюджет модели, а Высокое — как high от Fireworks, заметно меньший.

За использование собственных моделей платформенные кредиты не списываются — вы платите провайдеру напрямую. Использование всё равно записывается в историю расхода аккаунта.

Автоматический выбор модели всегда использует платформенные модели. Свои модели выбираются явно.

Модели эмбеддингов

Можно также добавить модель эмбеддингов (только OpenAI API) и сделать её моделью по умолчанию для аккаунта — тогда загрузка и поиск по документам будут использовать её. Укажите правильную размерность векторов (например, 1536). После смены модели эмбеддингов по умолчанию существующие базы знаний нужно загрузить заново: коллекции, проиндексированные другой моделью, перестают находить совпадения, а при загрузке появится ошибка размерности.

Отключение платформенных моделей

Переключатель Платформенные модели убирает платформенные модели (включая Авто) из списков выбора для вашего аккаунта, оставляя для выбора только ваши собственные модели.

Переключатель действует и на работающих агентов, а не только на списки выбора: агент, у которого всё ещё настроена платформенная модель (или Авто), перестаёт отвечать и сообщает, что платформенные модели отключены, пока вы не укажете ему одну из своих моделей. Так сделано намеренно — иначе агент, настроенный до того, как вы щёлкнули переключателем, продолжал бы тратить платформенные кредиты. Чат билдера ведёт себя так же: при выключенном переключателе он отказывается от Авто и просит выбрать одну из ваших моделей.

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