必须完成API密钥获取、供应商配置、模型注册与可用性验证四步闭环；任一环节缺失或粘贴错误，都会导致“模型不可用”或“Unauthorized”。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Dify中稳定调用百度千帆平台的文心一言或DeepSeek-R1等国产大模型，必须完成API密钥获取、供应商配置、模型注册与可用性验证四步闭环；任一环节缺失或粘贴错误，都会导致应用运行时提示“模型不可用”或“Unauthorized”，且错误信息不指向具体原因。
获取百度千帆API Key与Secret Key
登录百度智能云控制台→进入「千帆大模型平台」→点击左上角「应用管理」→选择「创建应用」；应用创建成功后，【必须手动切换至旧版控制台界面】，否则新版页面完全不显示Secret Key字段；在旧版「应用详情」页中，完整复制API Key与Secret Key，二者缺一不可。
若仅在新版页面操作，将永远无法看到Secret Key，Dify后续所有配置必然失败。
在Dify中添加百度千帆模型供应商
方法一：通过「模型供应商」页面添加（推荐）
① 登录Dify后台→右上角头像→「设置」→左侧菜单选择「模型供应商」；
② 向下滚动找到「百度智能云千帆(OpenAI-API-compatible)」→点击「开始添加模型」；
③ 填写模型名称（如ernie-4.0-turbo-8k）、基础URL（https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/ernie-4.0-turbo-8k）、API Key、Secret Key；
④ 点击「保存」，等待状态变为「已启用」即完成。
方法二：复用已有OpenAI兼容接口配置
若你已配置过通义千问或DeepSeek的OpenAI-API-compatible模型，可直接在同一区块内点击「添加模型」按钮，填入文心对应模型名与Endpoint；【Secret Key不能留空，也不能复用其他厂商的密钥】。
验证模型是否可用
进入「应用管理」→新建或编辑任意应用→在「模型配置」下拉菜单中选择刚添加的ernie-4.0-turbo-8k；输入测试提示词如“请用中文简述牛顿第一定律”，点击「运行」；若返回结构化JSON响应且含有效content字段，说明模型已成功接入；若提示“Unauthorized”或“Invalid API Key”，请立即返回模型供应商页面检查Secret Key是否粘贴完整、有无多余空格。
