Dify 接入 AI快站 OpenAI Compatible API 配置教程

配置前先验证 API

先确认 API Key 和模型列表可用：

curl https://www.aifast.club/v1/models \
  -H "Authorization: Bearer $API_KEY"

从响应中复制真实模型 ID，不要直接填写厂商名、中文展示名称或文章中的示例模型。

在 Dify 中添加模型供应商

Dify 的菜单名称会随云服务、社区版和插件版本变化，通常从工作区的“设置 / 模型供应商”进入。

1. 打开模型供应商页面。
2. 选择 OpenAI Compatible、OpenAI API Compatible 或支持自定义 Endpoint 的供应商插件。
3. 填入 AI快站 API Key。
4. Base URL 填写 https://www.aifast.club/v1。
5. 添加从 /v1/models 返回的真实模型 ID。
6. 根据实际能力选择聊天、Embedding、Rerank 等模型类型。
7. 保存并执行供应商提供的凭据验证。

如果插件会自动追加 /v1，应根据最终请求日志改填 https://www.aifast.club，避免出现 /v1/v1。

最小验证

新建一个只有开始节点和大语言模型节点的工作流：

1. 输入固定问题，例如“只回复 OK”。
2. 暂时关闭知识库、工具和复杂提示词。
3. 确认模型节点能返回文本。
4. 再逐步加入知识库、变量、结构化输出和工具。

基础聊天成功不代表 Embedding、Rerank、工具调用和多模态能力都可用，这些功能应分别选择对应模型并单独测试。

常见错误

凭据验证失败

• 检查 Key 是否完整。
• 确认请求头使用 Bearer Token。
• 检查 Base URL 是否重复出现 /v1/v1。

model not found

• 重新请求 /v1/models。
• 使用返回的 id，不要使用网页展示名称。
• 检查模型是否适用于当前节点类型。

工作流能对话但知识库失败

知识库通常还需要独立的 Embedding 模型。聊天模型可用，不代表向量模型已经配置。

429 或执行时间过长

降低并发，缩短上下文，检查余额、限流和工作流中的重复调用。不要对 401、400 和模型名称错误进行无限重试。