Dify如何连接大模型的API Key

这份教程将带你手把手完成 Dify 的大模型配置。无论你是想用国内的文心一言、通义千问，还是想通过中转平台使用国外的 ChatGPT 或 Claude，看完这篇文章都能轻松上手。

准备工作

在开始配置之前，请确保你已经：

1. 注册了 Dify 账号（云端版访问 dify.ai 即可）。
2. 获取了对应模型的 API Key（下文会详细说明去哪里领）。

第一步：找到 Dify 的配置入口

1. 登录 Dify 后，点击页面右上角的 “个人头像”。
2. 在弹出的菜单中选择 “设置” (Settings)。
3. 在左侧导航栏中点击 “模型供应商” (Model Provider)。

在这里，你会看到一个琳琅满目的模型列表，这就是我们要“插卡”的地方。

第二步：配置不同类型的模型

1. 国内大模型（直连，无需特殊环境）

国内模型（如通义千问、文心一言、智谱AI）对小白最友好，响应速度快，且支持人民币结算。

• 以“通义千问 (DashScope)”为例：
  • 获取 Key： 搜索“阿里云 DashScope”，进入控制台开通并创建 API Key。
  • 配置： 在 Dify 模型列表找到 阿里 DashScope，点击“设置”，将 sk-xxxx 开头的密钥粘贴进去即可。
• 以“深度求索 (DeepSeek)”为例：
  • 获取 Key： 访问 DeepSeek 开放平台，创建 API Key（目前性价比极高）。
  • 配置： 同样在 Dify 列表中找到 DeepSeek，填入 Key 即可。

2. 国外大模型（通过中转平台接入）

由于网络或账号限制，国内用户直接使用 OpenAI (ChatGPT) 或 Anthropic (Claude) 往往比较困难。此时，“大模型中转平台” 是小白的最佳选择。

中转平台原理： 它们帮你买好了国外的服务，你只需要付人民币给中转站，它们提供一个“兼容 OpenAI”的接口地址给你。

• 配置流程：
  1. 获取中转信息： 在中转平台（如 LinkAI、WildCard 等）购买额度后，你会得到：
     • API Key（通常也是 sk- 开头）
     • 代理地址 (Base URL)（例如 https://api.example.com/v1）
  2. 在 Dify 中设置： * 不要直接选 OpenAI 官方图标（除非你能直连）。
     • 下拉找到 OpenAI-API-compatible（OpenAI 兼容接口）。
     • 模型名称： 填你想用的模型，如 gpt-4o 或 claude-3-5-sonnet。
     • API Key： 填入中转平台给你的 Key。
     • API 端点 (Base URL)： 填入中转平台提供的地址（注意：这步最关键，不填默认会连美国官方服务器导致报错）。

3. 模型供应商分类速查表

第三步：设置默认模型

配置完 API Key 后，建议你设置一个 “系统默认模型”，这样你以后新建应用时就不需要每次都选了。

1. 在“模型供应商”页面上方，找到 “系统推理模型”。
2. 点击下拉框，选择你刚刚配置好的模型（比如 gpt-4o 或 qwen-max）。
3. 点击“保存”。

常见问题排查 (FAQ)

• 报错 “Invalid API Key”： 检查 Key 后面是不是多复制了一个空格，或者 Key 已经过期/额度用完。
• 报错 “Connection Timeout”： 如果使用的是国外模型且没填中转地址，大概率是网络不通。请检查“API 端点”是否正确。
• 模型列表里找不到某个模型： 有些供应商需要手动点击“添加模型”并输入模型 ID（如 gpt-4-turbo）。

下一步：

既然模型已经配置好了，你要不要试着去 “工作室 (Studio)” 创建你的第一个 “聊天助手” 呢？我可以教你如何写出让 AI 更听话的提示词（Prompt）。