Dify 接入 kkaiapi

最后更新:

安装并配置 Dify 的 OpenAI 兼容模型供应商,在最小 LLM 工作流中核对模型与实际调用,分开处理 embedding 和服务端网络。

在工作区安装并配置兼容模型供应商

在 Dify Workspace → Settings → Model Provider 中选择或安装 OpenAI-compatible 插件,添加 LLM 模型。字段名取决于插件版本,核心是服务端地址、Key、精确模型名和聊天模式。

配置项值
供应商OpenAI-compatible 插件
模型类型LLM / Chat
服务地址https://api.kkaiapi.com/v1
模型名claude-sonnet-5-5
API Key工作区安全保存的 KK Key

保存后验证一次聊天请求

配置完成后用一个短任务核对实际模型 ID 与 KK 调用记录,再单独验证工具往返、图片输入等所需能力。聊天成功只能证明该聊天路径可用。

import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["KKAI_API_KEY"],
                base_url="https://api.kkaiapi.com/v1", max_retries=0, timeout=120)
r = client.chat.completions.create(
    model="claude-sonnet-5-5",
    messages=[{"role": "user", "content": "请只回复 pong"}],
)
print(r.choices[0].message.content)

核对实际生效的工具路径

保存凭据后,在一个只有 LLM 节点的最小工作流中选中该模型,检查实际输出和调用记录;复杂知识库还需独立配置 embedding 与检索。自托管时检查 Dify API/插件进程的网络出口。

配置依据与能力验证

配置完成后用一个短任务核对实际模型 ID 与 KK 调用记录,再单独验证工具往返、图片输入等所需能力。聊天成功只能证明该聊天路径可用。

配置字段依据dify 官方说明;工具界面可能随版本变化,所需能力应在已安装版本中核对。

常见问题

为什么 API 请求成功,工具仍不能完成任务?

继续核对工具实际选择的 provider、模型、能力声明和运行进程的网络出口;工具调用、文件编辑和图片入口应分别验证。