Хотите проверить AI-workflow в n8n на одном контролируемом запросе? Создайте аккаунт BetterToken и API Key, затем откройте инструкцию для n8n и добавьте credential типа OpenAI. Соберите Manual Trigger, AI Agent и OpenAI Chat Model, ограничьте Max Retries и сопоставьте manual execution с моделью, status, Token и расходом в BetterToken Dashboard.
Что делает n8n в этом AI-процессе
n8n управляет последовательностью node и хранит execution data. OpenAI Chat Model отправляет запрос выбранной модели, а BetterToken принимает OpenAI-compatible API-вызов. Для первого теста достаточно трёх компонентов:
Manual Trigger → AI Agent
└─ OpenAI Chat Model
Manual Trigger исключает случайный запуск по расписанию или webhook. AI Agent получает фиксированный prompt, а Chat Model выполняет один модельный запрос. Мы не добавляем Telegram, email, базу данных, публикацию или другие node с внешним побочным эффектом.
BetterToken в этой схеме отвечает за API Key, Base URL, доступный Model ID и запись использования в Dashboard. Он не гарантирует совместимость всех community nodes или OpenAI-hosted tools. Доступ к BetterToken API Endpoint из России не требует VPN; доступность n8n Cloud, собственного сервера и сторонних integrations проверяется отдельно.
Как создать credential без утечки API Key
- Добавьте в workflow узел AI Agent.
- В разъёме Chat Model добавьте подузел OpenAI Chat Model.
- В поле Credential to connect with выберите Create new credential → OpenAI.
- Если интерфейс предлагает OpenAI Account (ChatGPT) и API Key, выберите API Key.
Заполните credential:
- API Key: ваш API Key BetterToken.
- Organization ID: оставить пустым.
- Base URL:
https://www.bettertoken.ai/v1. - Add Custom Header: выключить.
Сохраните credential в защищённом хранилище n8n. Не вставляйте ключ в prompt, workflow JSON, Code node, screenshot, execution data или репозиторий.
Текущие поля и режимы авторизации сверяйте с официальной документацией OpenAI credential в n8n.
Base URL должен заканчиваться на /v1. Не добавляйте /models, /chat/completions или /responses: n8n сам дополняет адрес. При сохранении credential n8n проверяет модели через /models относительно указанного Base URL.
Если список Model не появился, заново откройте credential и OpenAI Chat Model. Точный Model ID возьмите из текущей документации BetterToken для n8n или model plaza; статья не фиксирует динамический ID.
Как собрать минимальный AI workflow
1. Добавьте Manual Trigger
Создайте новый workflow и добавьте Manual Trigger. Пока идёт проверка, не публикуйте workflow: n8n рекомендует использовать manual executions при сборке и тестировании.
2. Настройте AI Agent
Соедините Manual Trigger с AI Agent. В параметрах prompt выберите ввод, который позволяет задать фиксированный текст, и используйте:
Верни только JSON: {"workflow":"n8n","sum":4}. Не вызывай tools и не выполняй внешние действия.
Не подключайте Tool nodes. Для этого теста нужен ответ модели, а не agent automation.
3. Подключите OpenAI Chat Model
В подузле OpenAI Chat Model:
- выберите созданный BetterToken credential;
- выберите точный Model ID;
- для первого запроса выключите Use Responses API и используйте Chat Completions;
- задайте конечный Timeout;
- установите Max Retries на минимальное значение, которое допускает текущая версия n8n.
Параметры Model, Use Responses API, Timeout и Max Retries описаны на официальной странице OpenAI Chat Model.
Responses API и встроенные Web Search, File Search или Code Interpreter не входят в этот тест. Их наличие в интерфейсе n8n не подтверждает поддержку выбранной моделью или endpoint.
4. Выполните ровно один manual run
Нажмите Execute Workflow. Успешный результат должен содержать JSON с workflow: "n8n" и sum: 4. Не повторяйте запуск сразу, если node вернул ошибку: сначала определите её класс.
Где смотреть execution log
Откройте Executions для текущего workflow и выберите manual execution. Проверьте:
- общий status execution;
- время начала и длительность;
- вход и выход AI Agent;
- node, на котором остановился процесс;
- текст ошибки без копирования credential или чувствительного prompt.
n8n различает manual и production executions. Manual run запускается из editor и подходит для теста; production execution начинается автоматически после публикации workflow или от trigger. Пока provider не проверен, оставьте workflow неопубликованным.
Различия между типами запуска и списками execution зафиксированы в документации n8n по executions.
Execution data может содержать вход и выход node. Для чувствительных workflow n8n поддерживает redaction, которое скрывает data, сохраняя metadata вроде status, timing и имён node. В этой инструкции prompt не содержит персональных данных или secret.
Как ограничить retries и разобрать ошибку
Автоматический retry полезен только для временных ошибок. Он также создаёт дополнительные API-запросы, поэтому влияет на расход и усложняет сопоставление с одним execution.
401/ Unauthorized: не повторяйте автоматически; сначала проверьте API Key и лишние пробелы.403: не повторяйте автоматически; проверьте доступ Key к выбранной модели.404/ model not found: не повторяйте автоматически; проверьте Base URL и точный Model ID.429: допускайте только ограниченный повтор после паузы; проверьте rate limit и число параллельных запусков.5xx/ timeout: не превышайте заданный лимит; проверьте status provider, Timeout и размер prompt.- Workflow error: не повторяйте до диагностики; проверьте node, expression и входные data.
Для первого теста держите Max Retries на минимуме и не добавляйте loop, Wait + повтор или error workflow с новым API-вызовом. Если нужен retry в production, задайте конечное число попыток и задержку, а затем проверьте, сколько запросов появилось в Dashboard.
n8n error workflow полезен для уведомлений о сбоях, но сам notification — внешний побочный эффект. Добавляйте его только после отдельной проверки и с собственными лимитами.
Механизм Error Trigger и состав данных failed execution описаны в официальном руководстве по error handling.
Как проверить Token и стоимость в Dashboard
Откройте BetterToken Dashboard сразу после одного manual run. Сопоставьте:
- узкое время запуска в n8n и время запроса в Dashboard;
- Model ID в OpenAI Chat Model и модель в записи использования;
- успешный или ошибочный status;
- input, output и применимый cache Token;
- соответствующий расход по этой записи.
Не рассчитывайте стоимость по старой статье или фиксированному числу за миллион Token. Модель и цена меняются; фактическое списание одного вызова берите из Dashboard, а текущую ставку — со страницы цен BetterToken.
Если один manual execution соответствует нескольким строкам в Dashboard, проверьте Max Retries и поведение Agent. Один visible workflow run может вызвать несколько модельных запросов, особенно при agent loop или Responses tools. Поэтому первая проверка использует фиксированный prompt, без tools и с минимальными повторами.
Частые ошибки
Credential test возвращает 401
Пересоздайте credential типа OpenAI, удалите пробелы вокруг API Key и убедитесь, что выбран режим API Key, а не OpenAI Account. Не выводите ключ в execution log.
Credential test или node возвращает 404
Base URL должен быть https://www.bettertoken.ai/v1. Не добавляйте /models или endpoint. Затем заново загрузите Model и выберите актуальный ID.
Обычный Chat работает, а Agent tools — нет
Вернитесь к минимальному workflow: выключите Use Responses API, удалите Tool nodes и повторите один фиксированный prompt. Это отделит provider connection от ограничения конкретного tool или workflow.
Execution успешный, но Dashboard показывает несколько запросов
Проверьте Max Retries и agent loop. Сравните timestamps и statuses. Не суммируйте строки вручную как один вызов, если n8n действительно отправил несколько запросов.
FAQ
Нужно ли публиковать workflow для проверки?
Нет. Manual execution из editor достаточно. Публикация включает production triggers и может запустить внешние действия без дополнительного подтверждения.
Можно ли использовать Responses API?
Можно только после отдельной проверки выбранной модели и endpoint. Для первого подключения используйте обычный Chat Completions без встроенных OpenAI tools.
Где хранится API Key BetterToken?
В credential n8n типа OpenAI. Не дублируйте его в node parameters, workflow JSON, prompt или repository.
Как понять реальную стоимость одного workflow?
Выполните один manual run с минимальными retries и сопоставьте execution time, Model ID и status с записью BetterToken Dashboard. Token и расход берите из этой записи, а не из оценочного примера.