需手动配置kimi模型：先在dify模型管理中确认未预置，再通过天工平台获取52位sk-开头api密钥，配置tiangong提供方及kimi-pro/kimi-long实例，最后在工作流中用llm或http节点调用实现长文本语义切片与推理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你在Dify里上传了一份30页的产品技术白皮书，AI检索时却总把“配置步骤”和“故障排查”混在一起回答；或者一份FAQ文档被切成178个碎片，每段只有两句话，AI根本拼不出完整逻辑——这不是模型不行，而是你没接入Kimi（Moonshot）长文本模型做语义感知型切片与推理。
确认Kimi未预置于Dify模型列表
打开Dify控制台 → 点击右上角头像 → 进入「模型管理」→ 查看「已启用模型」列表。滚动查找“kimi”“Moonshot”“kimi-pro”“kimi-long”等关键词，【若列表为空或仅显示Qwen、GLM等内置模型，则说明Kimi尚未接入】。Dify不预置Kimi模型，所有调用必须手动配置提供方与实例，跳过此步将导致后续节点报401或404错误。
获取合法有效的Kimi API密钥
访问天工开放平台官网（https://www.php.cn/link/e9a0c2712fc916cfe783cf1a058b6823），使用手机号+短信验证码登录账户。
进入「API密钥管理」→ 点击「创建新密钥」→ 必须勾选「kimi-plus」权限（仅此权限支持kimi-long、kimi-pro等主力长文本模型）→ 复制生成的密钥字符串。
【密钥必须以sk-开头且长度严格为52位】。若复制后开头为tg_、长度不足50或含空格，立即返回重创——此类密钥仅限网页端调试，Dify后端校验会直接拒绝。
在本地终端执行测试命令验证可用性：curl -X POST "https://api.tiangong.cn/v3/chat/completions" -H "Authorization: Bearer sk-xxx" -H "Content-Type: application/json" -d '{"model":"kimi-pro","messages":[{"role":"user","content":"你好"}]}'。返回HTTP 200且响应体含"choices"字段即为有效。
在Dify中注册天工为自定义模型提供方
登录Dify控制台 → 左侧导航栏点击「设置」→ 「模型配置」→ 右上角「添加模型提供方」。
填写表单：提供方名称输入tiangong（全小写，不可加空格或下划线）；API Base URL填写https://api.tiangong.cn/v3（末尾严禁加斜杠）；API Key粘贴上一步获取的52位密钥。
点击「保存」后，列表中应立即出现新记录，状态显示「已连接」。若显示「连接失败」，请检查URL是否误写为/v3/或密钥粘贴时带换行符。
配置kimi-pro或kimi-long模型实例
在「模型配置」页面 → 点击刚添加的tiangong提供方右侧「添加模型」按钮。
填写模型ID：kimi-pro（用于常规长文本理解）或kimi-long（专为256K上下文优化，需kimi-plus权限支持）；模型名称可自定义为“Kimi-Pro-生产”或“Kimi-Long-文档”；启用OpenAI兼容格式与流式响应开关。
【模型ID必须严格区分大小写，不可写作KIMI-PRO、kimi_pro或kimi pro】。Dify构造请求时会原样拼接，错误命名将触发400 Bad Request错误且无明确提示。
点击「保存」，该模型即出现在「已启用模型」列表中，状态为绿色「已启用」。
构建支持长文本分析的工作流
方法一：用LLM节点调用kimi-long处理原始文档
① 在应用工作流中新增「LLM节点」，模型选择刚配置的kimi-long；
② 输入内容设为文件解析节点输出的纯文本（确保已去除页眉、表格乱码、分页符等干扰）；
③ 提示词需明确约束上下文完整性：“你是一个技术文档结构分析师。请基于全文语义，识别出所有独立功能模块，每个模块输出必须包含标题、参数说明、操作步骤三要素。禁止跨段落截断，禁止拆分代码块或表格。用JSON格式返回，字段为modules: [{\"title\":\"\",\"content\":\"\"}]。”
方法二：用HTTP节点直连Kimi官方切片API（适合超长PDF转文本后二次分块）
新建一个HTTP节点，URL填写https://api.kimi.ai/v1/chunk；请求体设为application/json；传入参数包括text（base64编码后的原文）、max_tokens（设为1024）、overlap_ratio（设为0.15）；Header中添加Authorization: Bearer sk-xxx。
