Dify 可以接 OpenAI Compatible API 吗？

可以。Dify 支持配置兼容 OpenAI 格式的模型供应商。

Dify Base URL 要不要带 /v1？

要。一般填写 https://bottoken.cc/v1，不要把 /chat/completions 填到 Base URL。

Dify 连接失败怎么办？

检查 Base URL、API Key、模型名、余额和智模引擎请求日志。

Dify 可以同时用 Claude、Gemini、DeepSeek 吗？

可以，只要这些模型在智模引擎控制台可用，并在 Dify 中添加对应模型名。

ZZHIMO 智模引擎

API GUIDE

Dify接入OpenAI API中转教程：OpenAI Compatible 配置方法

通过智模引擎统一 API，你可以让 Dify 应用调用 OpenAI、Claude、Gemini、DeepSeek 等模型，并统一管理 Key、余额、日志和消耗。

准备工作字段填写配置步骤应用场景失败排查请求示例

立即注册进入控制台

Base URL

在 Dify 模型供应商中填写 https://bottoken.cc/v1。

API Key

使用智模引擎控制台创建的 Key，不要填写登录密码。

模型名称

按控制台可用模型名填写，用于知识库、Chatflow 和 Workflow。

准备工作

一个智模引擎账号，并确认账号可以正常登录控制台。
在控制台创建 API Key，后续填入 Dify 的模型供应商配置。
确认账户余额充足，并确认要使用的模型已经在控制台可见。
准备一个 Dify 应用，用于测试 Chatbot、Agent、Chatflow 或 Workflow。

Dify 字段应该怎么填

Dify 的关键点是选择兼容 OpenAI 格式的供应商，然后填写统一 Base URL 和智模引擎 API Key。

Dify 配置项	应填写内容	说明
Provider	OpenAI Compatible	选择兼容 OpenAI 格式的模型供应商。
Base URL	`https://bottoken.cc/v1`	注意带 `/v1`，不要填完整 chat/completions 路径。
API Key	智模引擎控制台创建的 Key	不要填写登录密码，也不要使用上游平台 Key。
Model Name	控制台可用模型名	例如 GPT、Claude、Gemini、DeepSeek 相关模型，按控制台实际名称填写。
Test	点击测试连接	失败时优先看 Key、余额、模型名、Base URL 和日志。

完整配置步骤

登录 Dify 后台，进入 设置 / 模型供应商。
选择 OpenAI Compatible 或自定义兼容供应商。
Base URL 填写 https://bottoken.cc/v1。
API Key 填写智模引擎控制台创建的 Key。
添加需要使用的模型名称，例如你控制台里可用的 GPT、Claude、Gemini 或 DeepSeek 模型。
点击测试连接。通过后，就可以在应用里选择该模型。

如果 Dify 提示连接失败，不要先改应用 Prompt，先回到模型供应商配置检查 Base URL、Key 和模型名。

知识库、Chatflow 和 Workflow 怎么用

知识库问答

在知识库问答应用中选择刚配置好的模型，让 Dify 负责召回文档，智模引擎负责统一模型调用和用量统计。

Chatflow / Workflow

在 LLM 节点中选择对应模型。如果你的流程里有分类、总结、改写、检索增强等多个节点，可以为不同节点选择不同模型，以控制成本和效果。

企业内部助手

对内部知识库、客服助手、数据分析助手，建议先使用轻量模型做意图识别，再把复杂问题转给更强模型。

Dify 测试连接失败怎么排查

401：检查 API Key 是否正确，Header 是否由 Dify 自动生成。
402 或余额不足：检查智模引擎账户余额。
404 或模型不存在：检查 Model Name 是否和控制台一致。
429：降低 Dify 并发，或在业务侧增加重试间隔。
超时：减少知识库召回数量、缩短输入，或换更快的模型。

更多状态码解释见 API 报错解决中心。

直接请求示例

如果你想先绕过 Dify 测试 Key 和模型是否可用，可以用 curl 直接请求：

curl https://bottoken.cc/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "用一句话介绍 Dify"}
    ],
    "stream": false
  }'

常见问题

Dify 可以接 OpenAI Compatible API 吗？
可以。Dify 支持配置兼容 OpenAI 格式的模型供应商。
Dify Base URL 要不要带 /v1？
要。一般填写 https://bottoken.cc/v1，不要把 /chat/completions 填到 Base URL。
Dify 连接失败怎么办？
检查 Base URL、API Key、模型名、余额和智模引擎请求日志。
Dify 可以同时用 Claude、Gemini、DeepSeek 吗？
可以，只要这些模型在智模引擎控制台可用，并在 Dify 中添加对应模型名。