ロシアでの n8n：AI ワークフロー、エラー、コスト
BetterToken を n8n に接続し、AI ワークフローを実行してリトライを制限し、各実行を Dashboard のトークンと請求額に照合します。
n8n の AI ワークフローを、管理できる一回のリクエストで試したいですか？ BetterToken の n8n ガイドを開き、自分の API Key を作成して、n8n に OpenAI credential を追加します。Manual Trigger、AI Agent、OpenAI Chat Model を接続し、Max Retries を制限したうえで、手動実行をモデル、ステータス、トークン使用量、BetterToken Dashboard の請求と照合してください。
この AI プロセスで n8n が担うこと
n8n はノードの順序を管理し、実行データを保存します。OpenAI Chat Model は選択したモデルへリクエストを送り、BetterToken は OpenAI 互換の API 呼び出しを受け取ります。最初のテストには次の三つで十分です。
Manual Trigger は、スケジュールや webhook による意図しない実行を防ぎます。AI Agent は固定の prompt を受け取り、Chat Model はモデルへ一回だけリクエストを送ります。Telegram、メール、データベース、公開、その他の外部副作用を持つノードは追加しないでください。
この構成で BetterToken が扱うのは API Key、Base URL、利用可能な Model ID、そして Dashboard 上の利用記録です。すべてのコミュニティノードや OpenAI ホストのツールとの互換性を保証するものではありません。ロシアから BetterToken API Endpoint へ接続する際に VPN は不要ですが、n8n Cloud、自分のサーバー、第三者連携の利用可否は別途確認が必要です。
API Key を漏らさず credential を作成する
- ワークフローに 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： 自分の BetterToken API Key。
- Organization ID： 空欄のままにします。
- Base URL：
https://www.bettertoken.ai/v1。 - Add Custom Header： オフにします。
credential は n8n の安全なストレージに保存してください。キーを prompt、ワークフロー JSON、Code node、スクリーンショット、実行データ、リポジトリに書き込んではいけません。
現在のフィールドと認可モードは、n8n の OpenAI credential 公式ドキュメントで確認してください。
Base URL は /v1 で終わる必要があります。/models、/chat/completions、/responses は追加しません。n8n がパスを補完します。credential を保存すると、n8n は指定した Base URL に対して /models を通じてモデルを確認します。
モデル一覧が表示されない場合は、credential と OpenAI Chat Model を開き直します。正確な Model ID は、最新の BetterToken の n8n ドキュメントまたはモデルカタログから取得してください。この記事で動的な ID を固定しません。
最小の AI ワークフローを組み立てる
1. Manual Trigger を追加する
新しいワークフローを作成し、Manual Trigger を追加します。テスト中はワークフローを公開しないでください。n8n は構築とテストの間、手動実行を推奨しています。
2. AI Agent を設定する
Manual Trigger を AI Agent に接続します。prompt の設定で固定テキストを指定できる入力を選び、次を使用します。
Tool nodes は接続しないでください。このテストで必要なのはモデルの応答であり、エージェントの自動化ではありません。
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. 手動で一回だけ実行する
Execute Workflow をクリックします。成功した結果には、workflow: "n8n" と sum: 4 を含む JSON が返るはずです。ノードがエラーを返しても、すぐに再実行せず、先にエラーの種類を判断してください。
実行ログを確認する場所
現在のワークフローで Executions を開き、手動実行を選びます。次を確認します。
- 実行全体のステータス。
- 開始時刻と所要時間。
- AI Agent の入力と出力。
- プロセスが停止したノード。
- credential や機密性の高い prompt をコピーしない形でのエラー文。
n8n は手動実行と本番実行を区別します。手動実行はエディタから開始し、テストに適しています。本番実行はワークフロー公開後または trigger から自動的に開始します。provider を確認するまでは、ワークフローを未公開のままにしてください。
実行タイプと実行一覧の違いは、n8n の Executions ドキュメントに記載されています。
実行データにはノードの入力と出力が含まれる場合があります。機微なワークフローでは、n8n の redaction を使うと、ステータス、時刻、ノード名などのメタデータを保ったままデータを隠せます。この手順の prompt には個人データや秘密情報は含まれていません。
リトライを制限してエラーを切り分ける
自動リトライが役立つのは一時的なエラーだけです。追加の API リクエストも発生するため、コストに影響し、一つの実行との照合が難しくなります。
401/ Unauthorized： 自動で繰り返さず、まず API Key と余分な空白を確認します。403： 自動で繰り返さず、選択したモデルに対するキーのアクセスを確認します。404/ model not found： 自動で繰り返さず、Base URL と正確な Model ID を確認します。429： 待機後に限られた回数だけ繰り返し、レート制限と並列実行数を確認します。5xx/ timeout： 定めた上限を超えず、provider の状態、Timeout、prompt のサイズを確認します。- Workflow error： 診断前に繰り返さず、ノード、式、入力データを確認します。
最初のテストでは Max Retries を最小に保ち、ループ、Wait + retry、新しい API 呼び出しを行う error workflow を追加しないでください。本番で retry が必要になった場合は、有限の試行回数と待機時間を設定し、Dashboard に何件のリクエストが現れたかを確認します。
n8n の error workflow は失敗通知に役立ちますが、通知自体も外部副作用です。個別に確認してから、自分で設定した制限付きで追加してください。
Error Trigger の仕組みと失敗した実行データの構成は、公式のエラー処理マニュアルで説明されています。
Dashboard でトークンと金額を確認する
手動実行の直後に BetterToken Dashboard を開きます。次を照合します。
- n8n の絞り込んだ開始時刻と Dashboard のリクエスト時刻。
- OpenAI Chat Model の Model ID と利用記録のモデル。
- 成功またはエラーのステータス。
- input、output、該当する cache Token。
- その記録に対応する請求額。
古い記事や 100 万 Token 当たりの固定値で金額を計算しないでください。モデルと価格は変わるため、1 回の呼び出しの実際の請求は Dashboard から、最新の料金は BetterToken の価格ページから確認します。
一つの手動実行が Dashboard の複数行に対応する場合は、Max Retries と Agent の動作を確認します。表示上は一回のワークフロー実行でも、特に Agent loop や Responses tools を使うと、複数のモデルリクエストを生むことがあります。そのため最初の確認では、固定 prompt、ツールなし、最小限の繰り返しを使います。
よくあるエラー
credential のテストで 401 が返る
OpenAI タイプの credential を作り直し、API Key の前後の空白を削除して、OpenAI Account ではなく API Key モードを選んでいることを確認します。実行ログにキーを表示しないでください。
credential のテストまたはノードで 404 が返る
Base URL は https://www.bettertoken.ai/v1 です。/models や endpoint は追加しません。その後、モデル一覧を再読み込みし、現在の ID を選びます。
通常の Chat は動くが Agent tools が動かない
最小ワークフローに戻ります。Use Responses API をオフにし、Tool nodes を削除して、固定 prompt を一回繰り返します。これにより、provider 接続と特定のツールまたはワークフローの制約を分けて確認できます。
実行は成功したのに Dashboard に複数のリクエストがある
Max Retries と Agent loop を確認します。時刻とステータスを比較してください。n8n が実際に複数のリクエストを送った場合は、各行を一回の呼び出しとして手動で合算しないでください。
よくある質問
確認のためにワークフローを公開する必要はありますか？
いいえ。エディタからの手動実行で十分です。公開すると本番 trigger が有効になり、追加の確認なしに外部アクションが始まる場合があります。
Responses API は使えますか？
選択したモデルと endpoint を別途確認した後に限ります。最初の接続では、組み込み OpenAI tools を使わない通常の Chat Completions を使用してください。
BetterToken API Key はどこに保存されますか？
n8n の OpenAI タイプ credential に保存されます。ノードパラメータ、ワークフロー JSON、prompt、リポジトリへ複製しないでください。
ワークフローの実際のコストはどう確認しますか？
最小限の retries で手動実行し、実行時刻、Model ID、ステータスを BetterToken Dashboard の記録と照合します。推定例ではなく、その記録にある Token と消費を使ってください。