BroadRouter

n8n で BroadNet Inference を使う(OpenAI 認証情報と Base URL)

更新日

n8n で OpenAI の認証情報を作成し、API Key に BroadNet のキー、Base URL に https://inference.broadnet.ai/v1 を設定します。OpenAI Chat Model ノードで Model を From List から ID に切り替えて broadnet/glm-5.3 などの BroadNet の ID を入力し、Use Responses API をオフにして n8n が chat completions を呼ぶようにします。

n8n はワークフロー自動化ツールです。OpenAI の認証情報には Base URL の欄があるので、OpenAI Chat Model ノード(と、この認証情報を使うほかの OpenAI ノード)から任意の OpenAI 互換 API を呼び出せます。BroadNet Inference もその 1 つです。n8n の認証情報のドキュメントページには Base URL の欄が載っていないため、以下のフィールド名は n8n のソースコードとも照合しました。リンクは出典にあります。

設定手順

  1. 認証情報を作成します。 n8n で Credentials を開き、新しい OpenAI の認証情報を作成して、次のように入力します。

    フィールド 値
    API Key BroadNet のキー
    Organization ID (optional) 空欄のまま
    Base URL https://inference.broadnet.ai/v1

    保存します。n8n は Base URL の /models を呼び出して認証情報をテストします。

  2. モデルのノードを追加します。 AI Agent または Basic LLM Chain ノードを追加し、OpenAI Chat Model サブノードをつないで、作成した認証情報を選びます。

  3. モデルを ID で指定します。 Model でモードを From List から ID に切り替え、broadnet/glm-5.3 と入力します。

  4. Use Responses API をオフにします。 n8n のソースコードでは、このトグルはノードのバージョン 1.3 から存在し、デフォルトでオンです。BroadNet が提供するのは chat completions なので、オフにしてください。

  5. オプションを設定します。 Options で、Maximum Number of Tokens はデフォルト(-1)のままにするか、数千に設定します。Max Retries のデフォルトは 2 です。失敗した呼び出しをもっと再試行させたい場合は上げてください。

  6. テスト用のプロンプトでワークフローを 1 回実行します。

OpenAI 以外の Base URL を使うと、n8n は「すべてのモデルがチャットに対応しているとは限らず、ツール呼び出しや JSON レスポンス形式に対応していない場合もある」という趣旨の通知を表示します。BroadNet では、どのチャットモデルでもチャットは動きますが、BroadNet のドキュメントでツールと構造化出力が記載されているのは GLM 5.3 と Qwen3.8 27B だけです。

モデルの選び方

ワークフロー モデル 理由
ツールを使う AI Agent broadnet/glm-5.3 BroadNet がツールと構造化出力を記載
画像、アラビア語のメッセージ broadnet/qwen3.8-27b ツール、画像入力、アラビア語でテスト済み
大量の分類 broadnet/gemma-4-26b-a4b トークン単価が低い。推論は記載なし
長いドキュメント broadnet/deepseek-v4.1-flash 100 万トークンのコンテキスト。ツールは記載なし

料金は料金ページで比較できます。音声の場合、n8n の HTTP Request ノードで /v1/audio/transcriptions にファイルを POST できます。送るフォームのフィールドはアラビア語音声認識のガイドにあります。

トラブルシューティング

  • 認証情報のテストが失敗する。 Base URL が /v1 で終わり、その後ろにパスがないか確認してください。チャットの呼び出しでも 401 が返る場合は、キーが間違っている、期限切れ、または従量課金の利用枠を使い切っています。
  • モデルのエラー。 ID モードを使い、broadnet/ プレフィックス付きの BroadNet の ID を正確に入力してください。GLM 5.3、Qwen3.8 27B、DeepSeek V4.1 Flash にはチャージが必要です。$5 の初回クレジットは BroadNet Gemma 4 VL 26B に使えます。
  • 「Bad request - please check your parameters」(不正なリクエスト。パラメーターを確認してください)。 n8n のドキュメントでは、HTTP Request ノードで同じ呼び出しを行い、エラーの全文を確認するよう勧めています。ここでよくある原因は Responses API のトグルです。
  • 出力が空。 推論は Maximum Number of Tokens に含まれます。値を上げてください。回答が空になる理由。
  • ループで 429。 従量課金のキーは毎分 30 リクエスト、同時実行 4 リクエストまでです。n8n のドキュメントでは、Loop Over Items と Wait ノードでバッチの間隔を空けることを勧めています。エラーとリトライを参照してください。
  • プランのキーで並列実行する場合。 無制限プランのセッションは同時に 1 リクエストしか処理しません。実行ごとにセッションがない限り、並列のワークフロー実行は待ち行列に入ります。

コードの方がよければ、同じ設定は LangChain でも使えます。n8n の AI ノードは LangChain をもとに作られています。

よくある質問

n8n の AI Agent が BroadNet で失敗するのはなぜですか?

OpenAI Chat Model ノードの Use Responses API がオフになっているか確認してください。ノードのバージョン 1.3 ではデフォルトでオンですが、BroadNet が提供するのは /v1/chat/completions で、Responses API はありません。あわせて Model を ID モードにし、BroadNet の ID を正確に入力してください。

モデルのドロップダウンが空、または内容がおかしいのはなぜですか?

From List モードはプロバイダーの /models エンドポイントを読みます。BroadNet のドキュメントでは、このエンドポイントは監視ツール向けの公開カタログのメタデータとされています。Model を ID モードに切り替え、BroadNet のモデル ID を入力してください。

n8n のエージェントの出力が空になるのはなぜですか?

推論が Maximum Number of Tokens を使い切っています。値を上げるか、デフォルトの -1 のままにしてください。

n8n の OpenAI 認証情報で、Base URL の欄はどこにありますか?

OpenAI の認証情報そのものの中で、API Key と Organization ID の下にあります。デフォルトは https://api.openai.com/v1 です。これを https://inference.broadnet.ai/v1 に置き換えてください。/v1 は残し、それ以上のパスは付けません。

Markdown で読むChatGPT に聞くClaude に聞くPerplexity に聞く