安装与入口
官方文档（2026-10-07 核对）：入口是 “Integrations > Model Provider”。供应商从页内 “Install model providers” 列表或 marketplace.dify.ai 安装——自 Dify v1.x 起供应商是插件，没装插件时列表里根本不会出现对应条目，这是“找不到我要的服务商”的第一原因。
Setup 与 Add Model 的字段顺序
安装后在供应商卡片点 Setup，填 API Key 与其他必填项——Dify 会先校验密钥，密钥不过它不会把供应商置为可用。预置列表没有的模型（新模型、微调模型），在卡片上点 Add Model，填模型名与凭据；如果新加的模型与已有条目名字和类型都相同，Dify 会复用原条目只更新密钥，而不是建重复项。注意：删掉某个模型的最后一把密钥，会把模型一起删掉。
OpenAI-API-compatible 插件：官方未明示的部分
第三方教程普遍声称 OpenAI-API-compatible 插件的 Endpoint URL 要以 /v1 结尾、且不要带 /chat/completions 后缀。这个要求在当前官方 cloud 文档页没有明文（2026-10-07 核对时未见）。处理原则：先按服务商文档的 base 地址原样填，连不通再试补 /v1；最终以插件安装后的字段提示为准，不要把第三方口径当成官方规格引用。
排错分层：密钥 → 端点 → 模型 ID
应用里选不到模型：供应商插件没装，或 Setup 未完成。Setup 报 key 无效：先按上面命令在终端验证密钥本身，再回 Dify。对话报模型不存在：Add Model 里的模型名与服务商实际 ID 拼写不一致——这是最高频错误，特别是倍率站点按分组限定可用模型时。一次只改一层。
# 排错第二步：绕开 Dify，先用与 Dify 同一把密钥在终端验证（把问题面一分为二）
# read -s 读入：不回显、不进 shell 历史；sk-... 只是占位写法
read -s PROVIDER_API_KEY && export PROVIDER_API_KEY
curl -sS --connect-timeout 10 --max-time 60 \
"https://api.example.com/v1/chat/completions" \
-H "Authorization: Bearer $PROVIDER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"MODEL_ID","messages":[{"role":"user","content":"ping"}],"max_tokens":16}'
# 密钥通 → 回 Dify 查 Add Model 的模型名与端点字段
# 密钥不通 → 问题在服务商侧，别在 Dify 里反复试验收条件
(1) 供应商卡片显示密钥已配置；(2) 目标模型出现在应用的模型选择器；(3) 在提示词编排里真实跑一次生成，服务商后台对应调用量增长——这三条把“配置完了”和“配置对了”区分开。