n8n

OpenAI認証情報のBase URLフィールドにhttps://api.kunavo.com/v1（/v1を維持）を指定すると、n8nワークフロー内のすべてのOpenAI Chat ModelがKunavoを利用します。モデルノード自体にはエンドポイントフィールドがありません。

Credentials  →  Create credential  →  OpenAI
  API Key                      sk-kn-...
  Organization ID (optional)   leave empty
  Base URL                     https://api.kunavo.com/v1     <- keep the /v1

Workflow  →  AI Agent or Basic LLM Chain  →  Chat Model: OpenAI Chat Model
  Credential to connect with   the OpenAI credential above
  Model                        ID mode:  claude-sonnet-5
  Use Responses API            on   → POST /v1/responses
                               off  → POST /v1/chat/completions

手順

1. /app/keys でキーを作成してコピーします。キーは一度だけ表示されます。
2. n8n で、種類が OpenAI の認証情報を作成します。キーを API Key に入力し、Organization ID (optional) は空欄にして、Base URL のデフォルト値 https://api.openai.com/v1 を https://api.kunavo.com/v1 に置き換えます。保存してください。
3. AI Agent または Basic LLM Chain ノードを追加し、その認証情報を使う OpenAI Chat Model サブノードを接続します。Model フィールドを From List から ID に切り替え、GET /v1/models に表示されているとおりに ID を入力します。たとえば claude-sonnet-5 です。リストから選ぶこともできますが、ID を入力しておくとワークフローが読みやすくなります。
4. Use Responses API を使うかどうかを決めます。チェーン内のツールが Chat Completions を必要とする場合、または n8n の実行ログに chat completions リクエストを表示したい場合を除き、オンのままにしてください。
5. トリガーに接続する前に、1行のプロンプトでワークフローを一度実行してください。401 はキーの問題です。コード missing_v1_prefix の 404（または以前の実行で、メッセージが <!DOCTYPE html> で始まる場合）は、Base URL の /v1 が抜けていることを示します。

n8n@2.41.4 タグの n8n OpenAI 認証情報ソースで2026年10月1日に確認しました。サードパーティの設定は変更されます。ここに記載されたフィールド名が表示内容と一致しなくなった場合は、このページではなく、そのページを正しい情報源としてください。

クライアントをデバッグする前に確認すること

1回のリクエストで、失敗の原因がエンドポイント、キー、設定ファイルのどれかを特定できます。これがJSONを返すなら、同じベースURLとキーがn8nで機能します。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

フィールドに入力するモデルID

すべてのテキストモデルにはモデルIDでアクセスできます。現在の一覧はGET /v1/models、価格付きのカタログはモデルページにあります。料金は100万トークンあたりのUSDで、入力 / 出力の順です。

認証情報にベース URL を設定する理由

古いチュートリアルでは、モデルノード内でエンドポイントを設定しています。リリース済みのソースでは、ノード内のベースURLオプションはノードバージョン1.1以降で非表示になっています。そのため、現在追加するノードにはこのフィールドがなく、認証情報のBase URLが適用されます。n8n自身のOpenAI Chat Modelドキュメントにも認証情報のページにも、このフィールドの説明はありません。ソースには「APIのデフォルトのベースURLを上書きする」と説明されています。HTTP Requestノードはまったく別の方法です。動作はしますが、AI Agentノードが自動で組み立てるリクエストを手動で組み立てることになります。

Responses API のオン／オフ

• オン（ノード 1.3 のデフォルト）— リクエストは /v1/responses に送信されます。このモードでのみ、ノードの Built-in Tools（Web Search、File Search、Code Interpreter）が表示されます。これらは OpenAI がホストするツールです。Kunavo 経由でテストした人はいないため、事前に試さずにこれらに依存するワークフローを構築しないでください。
• オフ — リクエストは /v1/chat/completions に送信されます。これは最も広くサポートされている形式で、もう一方の設定でツール呼び出しに問題が起きた場合の代替手段です。
• AI Agent に接続したツールは、関数定義としてモデルに送信されます。この往復処理は今回の確認に含まれていないため、ツール呼び出しに依存する前に、テスト用ワークフローで一度実行してください。

n8n と OpenRouter

n8n には、独自の OpenRouter 認証情報を使う専用の OpenRouter Chat Model ノードがあります。この認証情報の API Key フィールドとベース URL は非表示で、ベース URL は https://openrouter.ai/api/v1 に固定されています。また、テストでは OpenRouter 独自の /key ルートが呼び出されます。そのため、OpenRouter ノードが接続できるのは OpenRouter だけです。OpenRouter を使う場合は、OpenRouter のキーでそのノードを使用してください。このページの内容は必要ありません。

Kunavo を含むその他の OpenAI 互換エンドポイントには、上記のとおり OpenAI Chat Model と OpenAI 認証情報のベース URL を使用します。どちらを使うかは、必要なモデル、支払い方法、n8n と他のツールで残高をまとめたいかなど、実際の違いに基づいて選んでください。Kunavo との比較については、Kunavo と OpenRouter の比較をご覧ください。

無人ワークフローの料金を一定範囲に抑える

• ノードの Max Retries のデフォルトは 2、Timeout のデフォルトは 60000 ms です。タイムアウトしたリクエストは再試行され、再試行は新たな課金対象リクエストになります。
• 項目ごとに実行するノードでは、Maximum Number of Tokens を設定してください。1,000 行をループ処理すると、1回の呼び出しのコストがその回数分に増えます。
• 本番環境のワークフローごとに Kunavo キーを分けてください。使用状況ページでどのキーがいくら使ったか確認でき、他のキーに影響を与えずに1つのキーを無効化できます。

エラーの表示例

• 「401 APIキーがないか、無効です」 — Base URLは正しく、キーが正しくありません。2.41.4で再現済み。
• 「404 <!DOCTYPE html>…」は、LangChainによってMODEL_NOT_FOUNDに分類されますが、これは誤解を招きます。モデルに問題はなく、Base URLに/v1がないため、リクエストがウェブサイトに到達しています。2.41.4で再現済み。
• JSON 形式の「モデルを利用できません」というメッセージ — モデル ID が GET /v1/models と完全に一致していません。