主要な設定
前提条件
追加要件
- n8n Cloud またはセルフホスト型インスタンス
Base URL の末尾に
/v1 を保持します。n8n がノードに必要なルートを追加するため、/chat/completions や /responses は追加しないでください。インストール
n8n をインストールまたは開いてから、以下の手動設定に進みます。手動設定
この設定は n8n ノードの設定 UI で行います。n8n の設定ファイルを編集する必要はありません。セットアップ
1
AI Agent と OpenAI Chat Model を追加する
ワークフローを開き、AI Agent ノードを追加します。その Chat Model コネクターで OpenAI Chat Model サブノードを追加します。このガイドで OpenAI Chat Model を使用するのは、n8n AI Agents、チェーン、その他の AI ワークフローにモデル接続を提供するためです。
2
OpenAI Credential を作成する
OpenAI Chat Model で Credential to connect with を開き、Create new credential を選択して OpenAI を選びます。n8n のバージョンで OpenAI Account (ChatGPT) と API Key の両方が表示される場合は、API Key を選択します。OpenAI Account 認証は公式アカウント用であり、BetterToken のカスタム Base URL 用ではありません。
3
BetterToken Credential を入力する
次の値を使用します。
Save をクリックします。n8n は設定した Base URL の
/models に対してこの Credential をテストするため、完全なテスト URL は https://www.bettertoken.ai/v1/models です。4
モデルを選択する
OpenAI Chat Model に戻り、Model を開いて、モデル広場にある対応プロバイダーのモデル ID を選択します。Credential を保存してもリストが更新されない場合は、ノードまたは Credential を開き直してモデルリストを再度読み込みます。
5
Chat Completions または Responses を選択する
最初のテストでは Use Responses API をオフのままにし、デフォルトの Chat Completions モードで通常の会話を完了します。ワークフローで必要な場合にのみ Use Responses API をオンにします。n8n は Responses を有効にした OpenAI Chat Model + AI Agent の組み込みツールとして Web Search、File Search、Code Interpreter を案内しています。これらの OpenAI ホスト型ツールは BetterToken で自動的に確認された機能ではないため、選択したモデルと Endpoint でテストしてください。
6
テストを実行する
AI Agent に簡単な入力を渡します。Execute step をクリックするか、ワークフローを実行します。ノードがモデルの Response を返せば設定は完了です。
接続を確認する
短いテストプロンプトを送信します。認証エラーや Model ID エラーなしでツールから Response が返れば、接続は機能しています。設定を変更した後はツールを完全に再起動してください。モデルを切り替える
モデルセレクターを開くか、設定内のModel フィールドを変更します。モデル広場にある正確な Model ID を使用し、現在のセッションを再起動します。
よくあるエラー
Credential テストで 401 が返る
- API Key が完全であり、余分な空白がないことを確認します
- Key が対応プロバイダーの Model ID を使用していることを確認します
- BetterToken Dashboard で Key の状態と残高を確認します
Credential テストで 404 が返る
- Base URL は
https://www.bettertoken.ai/v1である必要があります https://www.bettertoken.ai/v1/modelsを Base URL として使用しないでください/chat/completionsや/responsesを追加しないでください
Model リストが空である
- Credential を再度保存してから、Model を開き直します
- API Key が
https://www.bettertoken.ai/v1/modelsにアクセスできることを確認します - モデル広場から現在のモデル ID をコピーします。廃止済みまたはスペルが誤った ID は使用しないでください
通常のチャットは機能するが Agent ツール呼び出しが失敗する
Use Responses API とすべての組み込みツールをオフにしてから、通常の Chat Completions を確認します。問題がモデル機能、ツール引数、ワークフロー設定のどれにあるかを特定するため、Agent ツールを 1 つずつ有効にします。Request がタイムアウトする
OpenAI Chat Model > Options の Timeout を増やし、Max Retries は限定的な値に保ちます。400、401、設定エラーを繰り返しリトライしないでください。
高度な設定
対応プロバイダー
ここに示す対応状況は、このページで説明する BetterToken の設定方法に適用されます。
設定方法の説明
設定方法の説明
- 手動設定：API Key、Base URL、Model を入力します。
- 未対応：検証済みの直接接続方法はまだありません。
関連ガイド
技術的な詳細
Protocol、Endpoint、内部プロバイダーフィールド
Protocol、Endpoint、内部プロバイダーフィールド
この設定では
https://www.bettertoken.ai/v1 を使用します。ツールが OpenAI 互換の Endpoint パスを追加します。特定のフィールドで明示的に必要とされない限り、/chat/completions や /responses を追加しないでください。