Dify 模型配置 · 人机协同指引模板（免费引流版）
适用场景
- 给 Dify 新增/更换模型供应商（火山方舟、DeepSeek、OpenAI 兼容接口等）
- 想把"配置模型"从手动网页点表单，升级为"AI 构造 + 人工授权 Key + 自动写入验证"
- 规避网页表单的反爬与反复登录问题
三种配置路径对比（先选路径再动手）
| 路径 | 人工工作量 | 自动化程度 | 风险 | 适用 |
|---|---|---|---|---|
| A 手动复制粘贴 | 高（逐字段） | 无 | 极低 | 一次性配置 |
| B 本机脚本自动化 | 中（拿Key+授权） | 中 | 低（页面改版会失效） | 少量模型 |
| C Dify OpenAPI | 低（只拿Key） | 高（Hermes可全自动） | 最低（绕开网页） | 长期/批量模型管理 |
C 路径·分步清单（推荐，人只做第 2 步）
| 步骤 | 谁做 | 动作 | 验证点 |
|---|---|---|---|
| 1 拿 API Token | 人工 | Dify 控制台→右上角头像→设置→API 密钥→创建 | Token 以 app- 开头 |
| 2 拿模型 Key | 人工 | 模型供应商控制台（如火山方舟）→API Key 管理→复制 | Key 不写入任何文档/聊天 |
| 3 构造请求 | AI | 按目标模型组装供应商/模型ID/BaseURL/Key | 请求 JSON 结构完整 |
| 4 校验 | AI | 非空校验、URL 必须 https、模型ID格式 | 输出校验清单 |
| 5 写入+验证 | AI | 调用 Dify OpenAPI 写入，回读配置确认生效 | 回读模型列表可见 |
硬性规则
- API Key 人工从控制台复制，只在使用者会话内存中使用，禁止写入文档/聊天记录/日志。
- 不编造接口地址与请求参数：目标模型的具体接口以官方文档为准，缺失则标"待人工确认"。
- 写入前必须校验（非空 + https + 格式），校验不过不写入。
- 写入失败：停止、存草稿、告警，不自动重试（防重复配置/错配）。
- 完成证据：回读 Dify 模型列表可见该模型，非"已提交"即算完成。
使用方式
- 把本模板交给你的 AI 助手（豆包/Hermes）。
- 提供：模型供应商、模型ID、BaseURL。
- 人工完成第 1、2 步授权，之后 AI 执行并贴回读证据。
升级通道
需要「多模型批量配置、Key 轮换自动化、配置变更审计日志、失败自动重试策略」等进阶能力，见付费专业版《Dify配置自动化工作台》（SkillHub 同作者 zsai-dify-config-pro）。
免责声明
仅用于您自有 Dify 实例与自有账号的合规配置；Key 请妥善保管，泄露请立即轮换。
