Dify 接入 BetterToken 配置指南
在 Dify 中配置 BetterToken Base URL、API Key 和模型，验证连接并排查常见错误。
要在 Dify 中使用 BetterToken，请准备 API Key，填写下表中的 Base URL，并从模型广场选择当前可用的 Model ID。
重点信息
| 字段 | 填写内容 |
|---|---|
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai/v1 |
| Model | 从模型广场复制的当前 Model ID |
准备工作
工具特定要求
- Dify Cloud 或已启用插件的自托管 Dify
- 有权限安装模型插件并管理 workspace 模型的 Dify 账号
安装
安装 OpenAI-compatible 模型插件
打开 Model Providers
在 Dify workspace 中进入 Integrations > Model Providers。
安装官方插件
点击 Install model providers，搜索并安装 OpenAI-API-compatible。
Dify 官方将模型能力作为 workspace 级插件管理。安装完成后，同一 workspace 中有权限的应用都可以选择该 provider 下的模型。
添加自定义模型
在 OpenAI-API-compatible 卡片中点击 Add Model。如果界面先显示 Setup 或 Configure，进入后再选择添加模型。
手动配置
主要通过 Dify 的模型供应商界面完成以下设置，不需要手动编辑配置文件。
| 字段 | 填写内容 |
|---|---|
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai/v1 |
| Model | 从模型广场复制的当前 Model ID |
填写模型配置
按照下表填写首个模型：
| Dify 字段 | 推荐值 |
|---|---|
| Model Type | LLM |
| Model Name | 从模型广场复制的模型 ID |
| Model display name | 可填写与 Model Name 相同的值 |
| API Key | 你的 BetterToken API Key |
| API Base URL | https://bettertoken.ai/v1 |
| model name for API endpoint | 与 Model Name 使用相同的模型 ID |
| Completion mode | Chat |
| Model context size | 按所选模型能力填写；不确定时先保留插件默认值 |
| Upper bound for max tokens | 不超过所选模型支持范围；可先保留插件默认值 |
| Compatibility mode | OpenAI compatible / strict |
| Token parameter name | Auto |
| Function Call Type | 首次验证选 Not Support |
对于其他可选能力，先按保守配置保存：
- Thinking Mode Support：只有确认当前模型支持时才开启
- Stream function calling：首次验证选
Not Support - Vision Support：只有模型和当前接口都支持图片输入时才开启
- Structured Output：先关闭；普通对话成功后再测试
Include Usage in Stream（stream_include_usage）保持默认值 Enabled。它会添加 stream_options: {include_usage: true}，以便在最后一个流式片段中获取 token 用量；仅当接口拒绝该字段时才关闭。Stream mode auth（stream_mode_auth）默认为 Not Use；选择 Use 会用流式请求验证凭据，不改变正常生成设置。参阅官方 provider 字段。
点击 Save。Dify 会验证 API Key、Base URL 和模型 ID。
在应用中使用模型
创建或打开 Dify 应用
打开 Chatbot、Agent、Chatflow 或 Workflow。
选择模型
在应用的模型选择器或 LLM 节点中，选择 OpenAI-API-compatible 下刚添加的模型。
先测试普通对话
使用一条不带工具、不带图片的短输入完成首次调用：
请只回复：连接成功再启用 Agent 能力
普通对话成功后，如果你需要工具调用，再编辑模型配置，将 Function Call Type 改为模型实际支持的模式。OpenAI-compatible 工具调用通常使用 Tool Call，但必须以当前模型和 endpoint 的实际支持情况为准。
验证连接
发送一条简短测试消息。工具正常返回内容，并且没有认证或 Model ID 错误，就说明连接成功。修改配置后请完全退出并重新启动工具。
切换模型
打开模型选择器，或修改配置中的 Model 字段。请填写模型广场中的完整 Model ID，然后重新启动当前会话。
Dify 的自定义模型按模型 ID 单独配置。需要另一个模型时，在同一个 provider 下再次点击 Add Model，使用新的 Model Name 和 model name for API endpoint，Base URL 与 API Key 可以继续复用。
常见错误
保存时返回 401
- 检查 API Key 是否完整
- 从模型广场复制准确的 Model ID。
- 检查 BetterToken Dashboard 中的密钥状态和余额
保存时返回 404
- API Base URL 必须是
https://bettertoken.ai/v1 - 不要追加
/chat/completions - 检查 model name for API endpoint 是否与模型广场中的 ID 完全一致
显示 model not found
Model Name 可以影响 Dify 中的显示和选择，而实际请求使用的模型名称由 model name for API endpoint 决定。建议两个字段都填写同一个模型 ID。
普通对话成功，但 Agent 工具失败
先把 Function Call Type 恢复为 Not Support，确认基础 LLM 节点正常。只有在所选模型支持工具调用时，才改为 Tool Call 并重新测试工具参数。
Knowledge 无法选择当前模型作为 Embedding Model
这是正常的。聊天 LLM 不能替代 embedding 模型。本指南没有确认 BetterToken 提供 Dify 所需的 embedding 或 rerank 接口，请为 Knowledge 单独配置受支持的 embedding provider。
进阶配置
相关指南
技术说明
协议、endpoint 与 provider 内部字段
本页配置使用 https://bettertoken.ai/v1。工具会自行拼接 OpenAI-compatible endpoint；除非具体字段明确要求，否则不要在 Base URL 后附加 /chat/completions 或 /responses。