# 在 Dify 中使用 BigModel.io

> 用 OpenAI-API-compatible 插件把 BigModel.io 模型添加到 Dify，API endpoint URL 填 https://bigmodel.io/v1，设置正确的上下文长度，并为智能体开启 Tool Call 函数调用。

网页版: https://bigmodel.io/zh-cn/docs/dify · 更新于 2026-10-18

Dify 通过 **OpenAI-API-compatible** 模型供应商插件接入第三方模型。每个 BigModel.io 模型单独添加一次，并设置各自的上下文长度和能力。请求发往 `/v1/chat/completions`，所有文本分组都支持。

| Dify 中的字段 | 值 |
|---|---|
| Model Type | LLM |
| Model Name | 准确的模型 ID，如 `glm-5.3` |
| API Key | 你的 BigModel.io API Key（`sk-...`） |
| API endpoint URL | `https://bigmodel.io/v1`（必须带 `/v1`） |
| Completion mode | Chat |
| Model context size | 模型页上的上下文窗口（默认 4096 太小） |
| Upper bound for max tokens | 模型页上的最大输出 |
| Function calling | 支持工具调用的模型选 Tool Call（不要选 "Not Supported"） |
| Vision support | 仅支持图片输入的模型开启 |

只有工作空间的所有者和管理员可以添加模型供应商。

## 添加模型

1. 打开 **设置 → 模型供应商**（Settings → Model Provider）。
2. 找到 **OpenAI-API-compatible**，未安装则先安装。
3. 在该供应商上点击 **添加模型**（Add Model）。
4. 按上表填写。endpoint URL 带 `/v1`、不带 `/chat/completions`，插件会自己拼上 `chat/completions`。
5. 只有模型支持时才设置 **Structured output** 和 **Stream function calling**。
6. 点击 **保存**，Dify 会先做一次测试调用。

需要几个模型就重复几次，例如 `kimi-k3`、`deepseek-v4-pro`。之后在应用的模型设置里选择即可。

## 验证配置

保存模型时已经做过测试调用。如需再确认，新建一个聊天助手应用，选中该模型，在预览中发送 "ping"，并在[用量](https://bigmodel.io/usage)页确认出现这条请求。

## 常见问题排查

**保存时返回 404。** endpoint URL 缺少 `/v1` 或带了 `/chat/completions`，改为 `https://bigmodel.io/v1`。

**保存时返回 503 `api_error`：`No available accounts: no available accounts supporting model: ...`。** Model Name 拼错，或 Key 所在分组不提供该模型。请从模型页复制 ID。

**保存时返回 403 `INSUFFICIENT_BALANCE`。** 余额为 0 或以下，到[充值页](https://bigmodel.io/purchase)充值。

**长对话被截断或报错。** Model context size 仍是 4096。编辑模型，填写真实的上下文窗口。

**智能体从不调用工具。** Function calling 设成了 "Not Supported"。编辑模型改为 **Tool Call**，并使用支持工具调用的模型。

**工作流运行时出现 429 `rate_limit_error`。** 并行节点超过了并发限制（"Too many pending requests" 或 "Concurrency limit exceeded for user"）。降低并行度或重试。429 `API_KEY_QUOTA_EXHAUSTED` 请在 [API Keys](https://bigmodel.io/keys) 提高 Key 额度。

## 相关文档

- [n8n](https://bigmodel.io/zh-cn/docs/n8n)：自动化工作流。
- [LobeChat](https://bigmodel.io/zh-cn/docs/lobechat)：对话界面。
- [工具调用](https://bigmodel.io/zh-cn/docs/tool-calling) 和[结构化输出](https://bigmodel.io/zh-cn/docs/structured-output)：模型能力说明。