Dify 接入第三方模型:OpenAI 兼容供应商配置全流程

三步完成 Dify 模型供应商配置

结论先行:Dify 接入 kkaiapi 只需要一个 API Key 和一个 endpoint 地址,不改任何代码。 第一步,安装供应商插件。Dify 1.0 之后模型供应商全部改为插件形式,进入 设置 > 模型供应商,列表里没有 OpenAI-API-compatible 就先到插件市场搜索安装。0.x 旧版在供应商列表底部自带,跳过这一步。 第二步,添加模型。点击 OpenAI-API-compatible 下的 添加模型,按下表填写。注意 API endpoint URL 填到 /v1 为止,Dify 会自动拼接 /chat/completions,自己带上后缀反而会 404。 第三步,保存前先在服务器上用 curl 验证 Key 和网络都通,返回正常 JSON 再回 Dify 保存。每个模型 ID 单独添加一次,常用组合是 deepseek-v4-flash 加 claude-sonnet-4-6,一个跑量一个保质量。

curl https://api.kkaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"ping"}]}'

工作流按节点选模型,这是 Dify 省钱的关键

Dify 工作流里每个 LLM 节点、问题分类器、参数提取器都独立选择模型。一条典型 RAG 流水线中,分类和改写节点的调用次数往往是最终生成节点的好几倍,但这些节点输出短、逻辑简单,用旗舰模型纯属浪费。 正确做法是按节点分层:量大的结构化小任务交给 deepseek-v4-flash,中间的检索问答用 glm-5 或 kimi-k2.6,只有直接面向用户的生成节点和错误代价高的终审节点才上 claude-sonnet-4-6、claude-opus-4-7 或 gpt-5.5。用户感知的回答质量由生成节点决定,前置节点降档基本无感,账单大头却砍掉了。

价格表:同一个 Key 调所有模型

kkaiapi 是面向中文开发者的 OpenAI 兼容模型中转,支付宝和微信支付直接充值,按量计费,没有订阅费和月最低消费。下表为全文唯一价格出处,单位 ¥/1M tokens(输入/输出)。在充值页 /topup 充值后生成 Key,一个 Key 通吃表内全部模型,Dify 里只需把不同模型 ID 各添加一次。

企业自部署 Dify 的四个注意点

如果服务器必须经代理出网,给 Dify 容器加代理环境变量,注意 NO_PROXY 要排除内部服务,否则数据库和向量库的内网请求也会被送进代理:

• 容器出网:Dify 的 api 和 worker 容器必须能访问 https://api.kkaiapi.com。内网环境先进容器跑上面的 curl,不通再逐层排查防火墙出站规则和 DNS。
• Key 管理:不要全公司共用一个 Key。kkaiapi 控制台支持创建多个 Key,按团队或按应用分配,用量按 Key 独立可查,月底对账不扯皮。
• 版本固定:Dify 插件化之后,升级大版本前先确认 OpenAI-API-compatible 插件兼容性。生产环境固定镜像 tag,不要用 latest。
• 降级预案:同一供应商下多添加几个模型 ID,主力模型异常时在节点里手动切换即可,不用动应用逻辑。

services:
  api:
    environment:
      HTTPS_PROXY: http://your-proxy:7890
      HTTP_PROXY: http://your-proxy:7890
      NO_PROXY: localhost,127.0.0.1,db,redis,weaviate
  worker:
    environment:
      HTTPS_PROXY: http://your-proxy:7890
      HTTP_PROXY: http://your-proxy:7890
      NO_PROXY: localhost,127.0.0.1,db,redis,weaviate

常见问题