# n8n

n8n の OpenAI クレデンシャルには、カスタムのベース URL を設定できます。一度設定すれば、AI Agent や Basic LLM Chain などのノードで NezhaGate のモデルを使えます。

> https://nezhagate.com/ja/docs/integrations/n8n

対象バージョン：n8n 2.42

## 1. OpenAI クレデンシャルを作成する

1. **Credentials** → **Add credential** → **OpenAI**。

2. **API Key** に NezhaGate のキーを、**Base URL** に `https://nezhagate.com/v1` を入力します。Organization ID は空のままにします。

3. 保存します。n8n は接続テストのためにモデル一覧を 1 回読み込みますが、これは課金されません。

Base URL`https://nezhagate.com/v1`

## 2. OpenAI Chat Model ノードでモデルを選ぶ

- **Model** → **From List** を選ぶと NezhaGate の全モデルが一覧表示されるので、対話モデルを選んでください。または **ID** を選んで `gpt-5.5` のように直接入力することもできます。

- **Use Responses API** は既定でオンになっていて、`/v1/responses` にリクエストを送ります。NezhaGate はこのエンドポイントで GPT モデルだけを提供しています。GPT 以外のモデルを使うときはオフにしてください。GPT モデルならどちらでも動きます。

- **Built-in Tools**（Web Search、File Search、Code Interpreter）はオフのままにしてください。これらは OpenAI がホストする機能です。

- **OpenAI** アプリノードの **Message a Model** は常に `/v1/responses` を使うため、GPT モデルでしか動きません。ほかのモデルには OpenAI Chat Model ノードを使ってください。

## Claude（任意）

**Anthropic** クレデンシャルを作成し、**Base URL** に `https://nezhagate.com/anthropic` を、同じ API キーを入力します。そのあと、Anthropic Chat Model ノードで Claude モデルを選んでください。

## テスト

**Chat Trigger** → **AI Agent** → **OpenAI Chat Model** というワークフローを組み、**Open chat** をクリックしてメッセージを送ってみてください。

## よくあるエラー

**クレデンシャルのテストが失敗する**

404 はベース URL に `/v1` がない、または間違っていることを示します（`https://nezhagate.com/v1` が正解です）。401 はキーが正しくないことを示します。

**あるモデルが 400、404、503 を返す**

多くは GPT 以外のモデルで **Use Responses API** がオンになっています。オフにしてください。

**エージェントがツールを呼び出さない、または JSON 出力が効かない**

すべてのモデルがツール呼び出しや JSON 出力に対応しているわけではありません。対応しているモデルを選んでください（各モデルの API ドキュメントをご確認ください）。
