Skip to main content
要在 n8n 中使用 BetterToken，请准备 API Key，填写下表中的 Base URL，并从模型广场选择当前可用的 Model ID。

​
重点信息

​
准备工作

​
工具特定要求

  • 可用的 n8n Cloud 或自托管实例
Base URL 必须保留末尾的 /v1。不要填写 /chat/completions 或 /responses，n8n 会根据节点功能自动拼接具体路径。

​
安装

安装或打开 n8n，然后继续完成下方手动配置。

​
手动配置

主要通过 n8n 的节点配置界面完成以下设置，不需要手动编辑 n8n 配置文件。

​
配置步骤

1

添加 AI Agent 和 OpenAI Chat Model

打开一个 workflow，添加 AI Agent 节点。然后在它的 Chat Model 连接位置添加 OpenAI Chat Model 子节点。本文使用 OpenAI Chat Model，因为它可以作为 n8n AI Agent、Chain 和其他 AI workflow 的模型节点。
2

创建 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。
3

填写 BetterToken 凭证

按下面填写：点击 Save。n8n 会使用当前 Base URL 的 /models 路径测试凭证，因此完整测试地址应为 https://bettertoken.ai/v1/models。
4

选择模型

回到 OpenAI Chat Model，打开 Model 列表，选择与模型广场一致的 受支持提供商的模型 ID。如果刚保存凭证后列表没有刷新，重新打开节点或 credential，再次加载模型列表。
5

选择 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 已确认支持的能力，请按实际模型和接口测试。
6

执行测试

给 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 或配置错误。

​
进阶配置

​
支持的提供商

状态仅针对本页介绍的 BetterToken 接入方式。
  • 手动配置：填写 API Key、Base URL 和 Model。
  • 不支持：当前没有经过验证的直接配置方式。

​
相关指南

​
技术说明

本页配置使用 https://bettertoken.ai/v1。工具会自行拼接 OpenAI-compatible endpoint；除非具体字段明确要求，否则不要在 Base URL 后附加 /chat/completions 或 /responses。

​
使用范围

本指南只确认通过 OpenAI-compatible 协议接入 LLM Chat。不要把 GPT 聊天模型当作 embedding、rerank、语音或图片模型使用。