n8n 接入 Claude 和 GPT：自定义 API Base URL 配置

n8n 是一款工作流自动化工具，可以自行部署，也可以使用 n8n Cloud。它的 AI 功能由 AI Agent、Basic LLM Chain 等根节点组成。每个根节点都有一个 Chat Model 接口，接在这里的模型子节点决定调用哪个 API。

模型节点从凭据（credential）中读取地址和密钥。在当前版本的 n8n 中（2026 年 10 月对照 n8n 源码和文档核实），OpenAI 凭据和 Anthropic 凭据都有 Base URL 字段。这就够了：不需要社区节点，也不需要用 HTTP Request 绕路。所有使用该凭据的工作流都会从你的 APIVAI 余额按 token 扣费。如果你也在 Dify 中搭建聊天应用，同一个密钥同样可用，见 Dify 接入 Claude 和 GPT。

大多数人先用 OpenAI 凭据即可。如果你的 Claude 工作流会反复发送很长的系统提示词，再加上 Anthropic 凭据，用提示词缓存降低输入费用。两种格式的通用说明见 OpenAI 兼容 API 和 Claude API 代理。

1. 用邮箱注册
2. 充值，$10 起，支持银行卡、加密货币、支付宝和微信支付
3. 在控制台创建密钥并复制。可以给密钥单独设置预算上限，适合无人值守运行的自动化任务。

1. 打开一个工作流，添加 AI Agent 节点（或 Basic LLM Chain）。
2. 点击 Chat Model 下方的 +，选择 OpenAI Chat Model。
3. 在 Credential to connect with 中选择 Create new credential。
4. 填写字段：

1. 点击 Save。n8n 会向 Base URL 请求 /models 来测试凭据。测试通过，说明密钥和地址都正确。

• Model： 打开列表选择模型。n8n 从 APIVAI 加载列表，所以你看到的就是密钥可用的 ID。也可以把该字段从 From List 切换为 ID，手动输入 claude-sonnet-4-6 这样的 ID。
• Use Responses API： 新版本节点默认开启。APIVAI 支持 Responses API，GPT 模型可以保持开启。使用 Claude 模型时请关闭，让节点走 Chat Completions。Built-in Tools 留空，改为给 Agent 接 n8n 的工具节点。
• Options → Maximum Number of Tokens： 如果设置上限，请设为 4096 或更高。思考（thinking）默认开启并计入输出，上限太小可能导致回答为空或被截断。

1. 在 Chat Model 下选择 Anthropic Chat Model，新建凭据。
2. API Key 填 APIVAI 密钥，Base URL 填：

不要加 /v1。n8n 测试凭据时请求 /v1/models，节点发送请求到 /v1/messages，这两个路径都会拼接在这个地址后面。

1. 在节点中从列表选择模型，或切换到 ID 手动输入。
2. 在 Options 中，Maximum Number of Tokens 保持 4096 或更高。工作流反复发送同一段很长的系统提示词时，开启 Prompt Caching（5 Minutes 或 1 Hour）；截至 2026-10-07，Claude Sonnet 4.6 的缓存读取为每 1M token $0.10。Thinking Mode 不要设置，保留模型默认行为。

在 Agent 前面加一个 When chat message received 触发器，打开聊天面板发一条短消息。Agent 回复后，这次请求会连同 token 数和费用显示在 APIVAI 控制台中。

每 1M 输入 / 输出 token 价格，截至 2026-10-07：

实用做法：路由、打标签、提取数据这类简单步骤用 Claude Haiku 4.5 或 GPT-6 Luna，只有需要规划和调用工具的 Agent 才用 Sonnet。同一个凭据下，每个节点都可以用不同的模型。

模型列表会随时间变化。请从价格页选取 ID，或直接询问 API：

自动化任务的费用很好估算，因为它们一遍遍发送结构相同的提示词。下面两个例子中，思考 token 按输出计算：

• 邮件分拣： 工作流每天用 Claude Haiku 4.5 给 200 封来信分类，每次约 2,000 输入、500 输出 token。一个月 6,000 次请求，费用为 $9.42，按官方价格为 $27.00。
• 客服 Agent： 基于 Claude Sonnet 4.6 的 AI Agent 每天处理 50 个工单，每个工单约调用模型 5 次（含工具调用），每次约 6,000 输入、800 输出 token。一个月 7,500 次调用：$78.12，按官方价格为 $225。

Agent 比单次调用贵，因为每一步都要重新发送对话和工具结果。先观察一天控制台数据，再按节点调整模型。更全面的价格对比见 2026 年 Claude API 价格。

只有对话部分可以。APIVAI 不提供 embeddings（向量嵌入），所以向量存储的 Embeddings 子节点需要单独配置一个嵌入服务商。根据检索结果回答问题的 Agent 仍然可以使用 APIVAI 的对话模型。

• 凭据测试失败或 401： 检查密钥是否完整复制、是否已被删除、余额或密钥预算是否还有剩余。Anthropic 凭据中，密钥必须填在 API Key 字段。
• 404： /v1 写错了。OpenAI 凭据必须是 https://api.apivai.com/v1，/v1 只出现一次。Anthropic 凭据必须是 https://api.apivai.com，不带 /v1；带了的话请求会发到 /v1/v1/messages。
• Model not found： n8n 提示在你的 Base URL 上找不到该模型。请使用准确的 ID，例如 claude-sonnet-4-6，不要用显示名称，ID 以 /v1/models 返回的为准。
• 回答为空或被截断： 把 Maximum Number of Tokens 提高到 4096 或更高，思考 token 会占用一部分额度。
• 用 OpenAI 凭据跑 Claude Agent 时报错： 在 OpenAI Chat Model 节点中关闭 Use Responses API 后重试。
• 429 Too Many Requests： 默认限制为每个密钥每分钟 60 次请求。把数据分成更小的批次处理，在节点选项中设置 Max Retries，或在节点设置中开启 Retry On Fail，也可以联系客服提高限额。

不需要。内置的 OpenAI 和 Anthropic 凭据都有 Base URL 字段，标准的模型节点就能用。

都能用，凭据字段相同。自部署实例需要能访问外网上的 api.apivai.com。

能。一个 APIVAI 密钥适用于所有模型，在 OpenAI 凭据和 Anthropic 凭据中都可以使用。

为 n8n 单独创建一个密钥，并在控制台给它设置预算上限。预算用完后，该密钥的请求会停止，不会耗光你的余额。密钥和限额的说明见文档。

请求和响应的内容不会被记录。只保留模型、token 数和费用等用量数据用于计费。

创建账户，充值 $10 起，然后把密钥填入 n8n。