必须通过天工开放平台获取52位sk-开头api密钥，在dify中添加tiangong提供方并配置正确url与密钥，再添加kimi-pro等严格大小写的模型实例，启用openai格式和流式响应，方可零代码接入。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Dify中零代码接入天工AI大模型（Kimi系列模型），必须通过其官方API服务调用，而非本地部署或Ollama方式；需先在天工开放平台获取有效API密钥，并在Dify模型配置中正确填写认证信息与请求端点，否则所有应用调试将返回401错误。
获取天工AI API密钥并确认可用性
登录天工开放平台是唯一合法获取密钥的途径，第三方渠道生成的密钥无法通过Dify校验。
访问 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":"你好"}]}'。返回200且含"choices"字段即为可用。
在Dify中添加天工为模型提供方
Dify不预置天工AI选项，必须手动注册为自定义提供方，且URL路径和Header格式必须严格匹配天工v3 API规范。
登录Dify控制台 → 左侧导航栏点击「设置」→ 选择「模型配置」→ 点击右上角「添加模型提供方」。
填写表单：提供方名称输入 tiangong（全小写，不可用空格或下划线）；API Base URL填写 https://api.tiangong.cn/v3；API Key粘贴上一步获取的52位密钥。
点击「保存」后，页面不会弹出成功提示，但列表中应立即出现一行新记录，状态显示「已连接」。若显示「连接失败」，请检查URL末尾是否误加斜杠（/v3/会导致404）。
配置kimi-pro等具体模型实例
天工模型ID区分大小写且不可简写，例如kimi-pro不能写作KIMI-PRO或kimi_pro，否则Dify构造请求时会触发400错误。
返回「模型配置」页面 → 在「模型列表」区域点击「添加模型」。
第一步：在「提供方」下拉菜单中选择 tiangong；
第二步：模型名称输入 kimi-pro（推荐首选，支持128K上下文）；
第三步：模型类型选 LLM，上下文长度填 131072（即128K，天工实际支持值）；
第四步：展开「高级设置」→ 将「请求体格式」设为 OpenAI（天工v3完全兼容OpenAI格式，选其他格式将导致payload解析失败）→ 勾选「启用流式响应」。
注意：若需使用kimi-long（支持200万字上下文），模型名称必须严格输入 kimi-long，且上下文长度需改为 2097152，否则超出部分文本会被静默截断。
在应用中切换并调试天工模型
模型配置完成后，无需重启Dify服务，新模型即时生效。
进入任意已创建的应用编辑页 → 点击画布中「模型」节点右侧的齿轮图标 → 在模型选择下拉框中找到 kimi-pro（或kimi-long）→ 点击确认。
点击顶部「调试」按钮 → 输入测试问题（建议用含长文档摘要需求的句子，如“请用3句话总结以下技术文档要点：……”）→ 观察右侧输出区是否返回结构化文本。
若返回 {"error":{"code":"invalid_api_key","message":"Invalid API key"}}，说明密钥未激活或已过期，请回到天工控制台刷新密钥；若返回 {"error":{"code":"model_not_found"}}，则模型名称拼写错误或未勾选对应权限。
