n8n 接入 BetterToken 配置指南
在 n8n 中配置 BetterToken Base URL、API Key 和模型，验证连接并排查常见错误。
要在 n8n 中使用 BetterToken，请准备 API Key，填写下表中的 Base URL，并从模型广场选择当前可用的 Model ID。
重点信息
| 字段 | 填写内容 |
|---|---|
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai/v1 |
| Model | 从模型广场复制的当前 Model ID |
准备工作
工具特定要求
- 可用的 n8n Cloud 或自托管实例
| 配置项 | 值 |
|---|---|
| Credential 类型 | OpenAI |
| Base URL | https://bettertoken.ai/v1 |
| API Key | 你的 BetterToken API Key |
| Organization ID | 留空 |
| Custom Header | 关闭 |
安装
安装或打开 n8n，然后继续完成下方手动配置。
手动配置
主要通过 n8n 的节点配置界面完成以下设置，不需要手动编辑 n8n 配置文件。
| 字段 | 填写内容 |
|---|---|
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai/v1 |
| Model | 从模型广场复制的当前 Model ID |
配置步骤
添加 AI Agent 和 OpenAI Chat Model
打开一个 workflow，添加 AI Agent 节点。然后在它的 Chat Model 连接位置添加 OpenAI Chat Model 子节点。
本文使用 OpenAI Chat Model，因为它可以作为 n8n AI Agent、Chain 和其他 AI workflow 的模型节点。
创建 OpenAI credential
在 OpenAI Chat Model 中打开 Credential to connect with，选择 Create new credential，然后选择 OpenAI。
如果当前版本同时提供 OpenAI Account (ChatGPT) 和 API Key，请选择 API Key。OpenAI Account 登录用于官方账号，不用于 BetterToken 自定义 Base URL。
填写 BetterToken 凭证
按下面填写：
| n8n 字段 | 填写内容 |
|---|---|
| API Key | 你的 BetterToken API Key |
| Organization ID (optional) | 留空 |
| Base URL | https://bettertoken.ai/v1 |
| Add Custom Header | 关闭 |
点击 Save。n8n 会使用当前 Base URL 的 /models 路径测试凭证，因此完整测试地址应为 https://bettertoken.ai/v1/models。
选择模型
回到 OpenAI Chat Model，打开 Model 列表，选择与模型广场一致的 模型 ID。
如果刚保存凭证后列表没有刷新，重新打开节点或 credential，再次加载模型列表。
选择 Chat Completions 或 Responses
首次验证建议关闭 Use Responses API，先使用默认的 Chat Completions 模式完成一轮普通对话。
如果你的 workflow 明确需要 Responses API，再打开 Use Responses API。n8n 官方说明中，Web Search、File Search 和 Code Interpreter 等内置工具只在 OpenAI Chat Model + AI Agent 且启用 Responses API 时可用；这些 OpenAI 官方内置工具不等同于 BetterToken 已确认支持的能力，请按实际模型和接口测试。
执行测试
给 AI Agent 添加一个简单输入，例如：
请只回复：连接成功点击 Execute step 或运行 workflow。节点返回模型回复后，配置即生效。
验证连接
发送一条简短测试消息。工具正常返回内容，并且没有认证或 Model ID 错误，就说明连接成功。修改配置后请完全退出并重新启动工具。
切换模型
打开模型选择器，或修改配置中的 Model 字段。请填写模型广场中的完整 Model ID，然后重新启动当前会话。
常见错误
Credential test 返回 401
- 确认 API Key 完整，没有多余空格
- 从模型广场复制准确的 Model ID。
- 在 BetterToken Dashboard 检查密钥状态和余额
Credential test 返回 404
- Base URL 必须是
https://bettertoken.ai/v1 - 不要把 Base URL 写成
https://bettertoken.ai/v1/models - 不要在 Base URL 后追加
/chat/completions或/responses
Model 列表为空
- 重新保存 credential，再打开 Model 列表
- 确认
https://bettertoken.ai/v1/models可通过当前 API Key 访问 - 确认模型 ID 来自当前模型广场，不要使用已经下线或拼写不一致的 ID
普通对话可用，但 Agent 工具调用失败
先关闭 Use Responses API 和内置工具，验证普通 Chat Completions。随后逐项启用 Agent 工具，以便定位是模型能力、工具参数还是 workflow 配置问题。
请求超时
在 OpenAI Chat Model > Options 中提高 Timeout，并保留有限的 Max Retries。不要无限重试 400、401 或配置错误。
进阶配置
相关指南
技术说明
协议、endpoint 与 provider 内部字段
本页配置使用 https://bettertoken.ai/v1。工具会自行拼接 OpenAI-compatible endpoint；除非具体字段明确要求，否则不要在 Base URL 后附加 /chat/completions 或 /responses。
使用范围
本指南只确认通过 OpenAI-compatible 协议接入 LLM Chat。不要把 GPT 聊天模型当作 embedding、rerank、语音或图片模型使用。