Dify - 可视化 AI 应用开发平台
在 Dify 中通过 OpenAI 兼容模型供应商接入 88API，并完成模型配置、对话验证和常见问题排查。
适用范围
本教程适用于 Dify Cloud 和当前版本的 Dify 自托管版，主线是通过官方 OpenAI-API-compatible 模型供应商插件接入 88API 的聊天模型。
Dify 可以用可视化方式编排 Chatflow、Workflow、知识库和 Agent。模型凭据在整个工作空间内共享，因此只有工作空间所有者或管理员可以完成下面的供应商配置。
本页依据 Dify 模型供应商文档和 OpenAI-API-compatible 官方插件整理。页面中的配置图来自 Dify 官方插件仓库，不是生成式界面图。
使用前准备
- 登录 88API，创建 API Key，并确认账户有可用余额。
- 确认要使用的模型 ID。模型名称必须与 88API
/v1/models返回值完全一致。 - 使用 Dify 工作空间所有者或管理员账号登录。
- 自托管 Dify 建议先更新到当前稳定版本，并更新模型供应商插件。
安装模型供应商
- 在 Dify 左侧进入 集成 → 模型供应商。
- 在“安装模型供应商”区域搜索 OpenAI-API-compatible；如果本页没有显示，可从 Marketplace 打开并安装。
- 安装完成后回到模型供应商页面，打开该供应商卡片。
- 点击 添加模型。
为什么不直接选择 OpenAI
88API 使用 OpenAI 兼容接口，但 API 地址不是 OpenAI 官方地址。使用 OpenAI-API-compatible 插件可以明确填写自定义接口地址和模型 ID。
添加 88API 聊天模型
在“Add OpenAI-API-compatible”窗口中填写模型信息。不同 Dify 版本可能把地址字段显示为 API endpoint URL 或 API Base URL，两者都填写同一个 88API 基础地址。
图中是在 Dify 官方插件界面底图上标出的 88API 实际填写顺序：选择 LLM，填写精确模型 ID、API Key 和 https://88api.ai/v1，确认 Completion mode 为 Chat 后保存。示例模型 gpt-4.1 仅用于展示字段位置，实际应以当前账户 /v1/models 返回的模型 ID 为准。
| 字段 | 填写内容 | 说明 |
|---|---|---|
| Model Type | LLM | 本教程配置聊天模型 |
| Model Name | 88API 返回的精确模型 ID | 不要填写展示名称或自行缩写 |
| API Key | 你的 88API API Key | 不要在截图、工单或公开文件中展示完整密钥 |
| API endpoint URL / API Base URL | https://88api.ai/v1 | 填到 /v1 根路径，不要再追加 /chat/completions |
| Completion mode | Chat | 使用 Chat Completions 消息格式 |
| Model context size | 模型真实上下文长度 | 不确定时查看该模型说明，不要随意填写极大数值 |
| Upper bound for max tokens | 模型真实输出上限 | 该值不是账户余额或上下文总长度 |
其余能力建议先按最保守方式配置：
- Compatibility mode：先选择严格 OpenAI 兼容模式（strict）。
- Token parameter：先使用自动（auto）。
- Function calling：只有所选模型和 88API 渠道实测支持工具调用时才开启。
- Stream function calling：只有流式工具调用也已验证时才开启。
- Vision / Audio / Video / Document：这些开关描述模型输入能力，不会让原本不支持的模型自动获得对应能力。
填写完成后点击 保存。Dify 会在线验证凭据；只有验证通过后，模型才会出现在应用和工作流的模型列表中。
在应用中使用
- 新建一个基础聊天应用，或打开现有 Chatflow / Workflow。
- 在 LLM 节点的模型选择器中找到刚添加的模型。
- 先使用纯文本提示词测试，例如“回复 88API 连接成功”。
- 运行一次预览，确认 Dify 返回正常文本。
- 打开 88API 控制台的使用日志，核对同一时间是否出现对应请求记录。
先验证普通对话，再开启高级能力
工具调用、结构化输出、视觉输入和思考内容不仅取决于 Dify 开关，还取决于具体模型、渠道以及上游返回格式。普通对话成功不代表所有高级能力都兼容。
知识库与 Embedding
Dify 的知识库需要单独配置 Text Embedding 模型。聊天模型只负责生成回答，不能代替向量模型：
- 回到 OpenAI-API-compatible 供应商，点击 添加模型。
- Model Type 选择 Text Embedding。
- 填写一个确实支持 OpenAI
/v1/embeddings的 88API 模型 ID。 - 保存并验证后，在 Dify 右上角的默认模型设置中选择该 Embedding 模型。
官方插件还支持 Rerank、Speech2Text 和 TTS，但每一种都需要单独添加并验证。插件 README 明确提醒：部分非 LLM 后端会自行拼接 API 版本路径；如果日志出现重复的 /v1/v1，不要继续重试，应按照该模型类型的实际端点调整基础地址。
验证清单
- Dify 保存模型时凭据验证通过。
- 应用的 LLM 节点可以选到刚添加的模型。
- 纯文本测试返回正常内容，而不是空响应或 HTML 错误页。
- 88API 使用日志中出现同一模型和时间的调用记录。
- 若使用知识库，Embedding 模型也已单独验证并设为默认值。
常见问题
找不到“添加模型”或不能保存
确认当前账号是工作空间所有者或管理员，并确认 OpenAI-API-compatible 插件已经安装。普通成员不能管理工作空间模型凭据。
返回 401 认证失败
重新复制 88API API Key，确认没有多余空格、换行或全角字符。不要填写 Codex、Claude 或其他产品的登录令牌。
返回 404 或模型不存在
API 地址应为 https://88api.ai/v1，不要填写到具体的 /chat/completions。同时核对 Model Name 是否与 /v1/models 返回值完全一致。
普通聊天正常，工具调用失败
先关闭 Function calling 和 Stream function calling，再确认模型本身是否支持工具调用。仅在 88API 与目标模型均返回标准工具调用结构时开启。
自托管版升级后旧凭据不可用
Dify 1.14.x 曾出现迁移后 OpenAI-compatible 凭据不可用的问题，相关 官方 issue 已关闭。旧实例应先更新 Dify 和插件，再重新验证或重建该模型凭据；不要把历史迁移问题误判为 88API 接口故障。