n8n を BetterToken に接続する設定
Base URL、API Key、モデルで n8n を BetterToken に接続し、接続確認とよくあるエラーの解決を行います。
n8n を BetterToken に接続するには、API Key を用意し、以下の Base URL を入力して、モデル広場から現在の Model ID を選択します。
主要な設定
| 項目 | 値 |
|---|---|
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai/v1 |
| Model | モデル広場にある現在の Model ID |
前提条件
アカウントをお持ちの方は、ログインして残高をチャージし、コンソールでキーを作成してください。
追加要件
- n8n Cloud またはセルフホスト型インスタンス
| 設定 | 値 |
|---|---|
| Credential type | OpenAI |
| Base URL | https://bettertoken.ai/v1 |
| API Key | BetterToken API Key |
| Organization ID | 空欄のままにします |
| Custom Header | オフ |
インストール
n8n をインストールまたは開いてから、以下の手動設定に進みます。
手動設定
この設定は n8n ノードの設定 UI で行います。n8n の設定ファイルを編集する必要はありません。
| 項目 | 値 |
|---|---|
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai/v1 |
| Model | モデル広場にある現在の Model ID |
セットアップ
AI Agent と OpenAI Chat Model を追加する
ワークフローを開き、AI Agent ノードを追加します。その Chat Model コネクターで OpenAI Chat Model サブノードを追加します。
このガイドで OpenAI Chat Model を使用するのは、n8n AI Agents、チェーン、その他の AI ワークフローにモデル接続を提供するためです。
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 用ではありません。
BetterToken Credential を入力する
次の値を使用します。
| n8n の項目 | 値 |
|---|---|
| API Key | BetterToken API Key |
| Organization ID (optional) | 空欄のままにします |
| Base URL | https://bettertoken.ai/v1 |
| Add Custom Header | オフ |
Save をクリックします。n8n は設定した Base URL の /models に対してこの Credential をテストするため、完全なテスト URL は https://bettertoken.ai/v1/models です。
モデルを選択する
OpenAI Chat Model に戻り、Model を開いて、モデル広場にあるモデル ID を選択します。
Credential を保存してもリストが更新されない場合は、ノードまたは Credential を開き直してモデルリストを再度読み込みます。
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 でテストしてください。
テストを実行する
AI Agent に簡単な入力を渡します。
Reply with exactly: Connection successfulExecute step をクリックするか、ワークフローを実行します。ノードがモデルの Response を返せば設定は完了です。
接続を確認する
短いテストプロンプトを送信します。認証エラーや Model ID エラーなしでツールから Response が返れば、接続は機能しています。設定を変更した後はツールを完全に再起動してください。
モデルを切り替える
モデルセレクターを開くか、設定内の Model フィールドを変更します。モデル広場にある正確な Model ID を使用し、現在のセッションを再起動します。
よくあるエラー
Credential テストで 401 が返る
- API Key が完全であり、余分な空白がないことを確認します
- モデル広場から正確な Model ID をコピーしてください。
- BetterToken Dashboard で Key の状態と残高を確認します
Credential テストで 404 が返る
- Base URL は
https://bettertoken.ai/v1である必要があります https://bettertoken.ai/v1/modelsを Base URL として使用しないでください/chat/completionsや/responsesを追加しないでください
Model リストが空である
- Credential を再度保存してから、Model を開き直します
- API Key が
https://bettertoken.ai/v1/modelsにアクセスできることを確認します - モデル広場から現在のモデル ID をコピーします。廃止済みまたはスペルが誤った ID は使用しないでください
通常のチャットは機能するが Agent ツール呼び出しが失敗する
Use Responses API とすべての組み込みツールをオフにしてから、通常の Chat Completions を確認します。問題がモデル機能、ツール引数、ワークフロー設定のどれにあるかを特定するため、Agent ツールを 1 つずつ有効にします。
Request がタイムアウトする
OpenAI Chat Model > Options の Timeout を増やし、Max Retries は限定的な値に保ちます。400、401、設定エラーを繰り返しリトライしないでください。
高度な設定
関連ガイド
技術的な詳細
Protocol、Endpoint、内部プロバイダーフィールド
この設定では https://bettertoken.ai/v1 を使用します。ツールが OpenAI 互換の Endpoint パスを追加します。特定のフィールドで明示的に必要とされない限り、/chat/completions や /responses を追加しないでください。
対象範囲
このガイドで確認するのは、OpenAI 互換プロトコルによる LLM Chat のみです。GPT チャットモデルを embedding、rerank、speech、image モデルとして設定しないでください。
