配置速查
Dify 除了地址和密钥，还要填模型名和模型类型。
| 配置项 | 填什么 | 容易错在哪 |
|---|---|---|
Base URL | https://turingapi.space/v1 | 末尾加 /chat/completions 会失败 |
API Key | 控制台创建的 sk- 密钥 | 每个供应商条目单独填一次 |
模型类型 | LLM / Embedding / Text Embedding | 选错类型会提示模型不可用 |
前置准备
配之前先把要用的模型分好类。
在 注册页 建账号，控制台新建密钥并保存。
控制台「模型广场」能看到范围。Dify 建知识库需要 embedding 模型，多数分组只开放对话模型，这点要先确认。
只要对话，建一条；要用知识库，再建一条 embedding 的。
配置步骤
在「模型供应商」里操作，配完记得去系统模型设置里启用。
添加兼容供应商 主流程
- 进入「设置 → 模型供应商」
- 找到
OpenAI-API-compatible，点添加模型 - 模型类型选
LLM - Model name 填站内模型名
- API Key 填你的密钥
- Base URL 填
https://turingapi.space/v1 - 保存并测试
Base URL 只填到 /v1，Dify 会自己拼具体路径。
配置 Embedding 模型 知识库必做
- 再添加一条，模型类型选
Text Embedding - 模型名填分组里实际存在的 embedding 模型
- 同样填地址和密钥
- 保存后到「系统模型设置」里把它设为知识库的默认嵌入模型
分组里没有 embedding 模型时，这一步无论如何都过不去，知识库功能只能放弃。
测试连接失败 常见故障
- 确认 Base URL 精确到
/v1 - 确认模型名拼写正确且在该分组内
- 用 curl 直接测一次
/v1/models
curl -H "Authorization: Bearer sk-你的密钥" \
https://turingapi.space/v1/modelscurl 通而 Dify 失败，多半是 Dify 所在网络出不去，或者填了多余的路径。
验证是否配置成功
看到这些就说明通了
- 模型供应商页面显示已配置成功
- 在「系统模型设置」里能看到并选中该模型
- 新建一个应用，对话能正常返回
系统模型设置里能选中，说明 Dify 已经把它当可用模型了。
应用里调不通但测试通过
- 确认应用里选的是这个供应商下的模型
- 确认没有启用别的默认模型覆盖
- 看应用日志里的实际请求地址
Dify 应用级有独立的模型选择，供应商配好不等于应用在用。
常见问题
Dify 的问题集中在模型类型和系统设置两层。
为什么测试连接一直失败？
三个原因占绝大多数：Base URL 多写了路径、模型名不在该分组、密钥无效。先用 curl 打通 /v1/models，能通就说明是 Dify 里的填法问题。
知识库建不起来，提示缺少嵌入模型？
需要单独配置一个 embedding 类型的供应商记录，并在「系统模型设置」里设为默认。如果分组本身没有 embedding 模型，这个功能用不了。
Base URL 要填到哪一层？
填到 /v1 为止，https://turingapi.space/v1。不要带 /chat/completions，Dify 会自己拼。
配好了但应用里选不到模型？
去「系统模型设置」里确认这个模型已经启用，并且在该应用的类型下可见。供应商配好和应用能选是两件事。
相关客户端
Nn8n
凭据里覆盖 Base URL，两种节点位置不同
OOpen WebUI
管理员面板配置，模型自动同步
OOpenAI Python SDK
改一个参数，业务代码不用动
通通用 OpenAI 兼容
两种地址写法，互换一次就能解决大半问题
接入过程卡住了？到 QQ 群 1128182538 说明「客户端 + 报错码 + 时间点」，比只说"用不了"好排查得多。其他通用问题见 常见问题。