# n8n

n8n 的 OpenAI 凭证可以改 Base URL。改好之后，AI Agent、Basic LLM Chain 等节点都能使用 NezhaGate 的模型。

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

按此版本编写：n8n 2.42

## 1. 新建 OpenAI 凭证

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

2. **API Key** 填你的 NezhaGate Key，**Base URL** 填 `https://nezhagate.com/v1`，Organization ID 留空。

3. 保存。n8n 会读取一次模型列表来测试连接，这一步不计费。

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 模型时开关都可以。

- **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 Key 用同一把 Key，然后在 Anthropic Chat Model 节点里选择 Claude 模型。

## 测试

搭一个 **Chat Trigger** → **AI Agent** → **OpenAI Chat Model** 的工作流，点 **Open chat** 发一条消息。

## 常见问题

**凭证测试失败**

404 是 Base URL 少了 `/v1` 或写错了（应为 `https://nezhagate.com/v1`）；401 是 Key 不对。

**某个模型返回 400、404 或 503**

多半是 **Use Responses API** 开着、而模型不是 GPT。关掉这个开关。

**Agent 不调用工具，或 JSON 输出不生效**

不是每个模型都支持工具调用和 JSON 输出，换一个支持的模型（见各模型的 API 文档）。