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、模型、能力声明和运行进程的网络出口;工具调用、文件编辑和图片入口应分别验证。