配置 DeepSeek API
创建 API Key，在 Settings → Models 中保存，选择模型，并核对 DSH 实际保存和使用的配置。
本页内容
Key 已保存仍报错？查看 Web / Headless 差异、子代理路由和社区反馈 →
开始前
DSH 应当已经通过 npx @deepseek-ai/dsh web 正常运行。默认地址是 http://127.0.0.1:3080。如果启动本身报错，先完成启动排查。
不要把真实 Key 放进截图、代码仓库、Prompt 或公开的支持消息中。
获取 DeepSeek API Key
打开 DeepSeek API Keys，登录后创建或复制一个 Key。
打开 Settings → Models
在本机 DSH Web UI 中打开 Settings，再选择 Models。
只有使用企业网关、自托管端点或列表中没有的服务商时，才需要 Add a custom provider。使用 DeepSeek 官方 API 时直接配置内置 DeepSeek 卡片最简单。
粘贴并保存 Key
把 Key 粘贴到 DeepSeek 服务商卡片并保存。官方文档说明，内置 DeepSeek 凭证存储在 $DSH_HOME/.credentials.yaml；Settings 只保留凭证引用，界面保存后拿到的是脱敏描述，不会回显原始密钥。
保存服务商后不需要重启服务器，模型/服务商修改会在下一次请求生效。
选择模型
打开模型选择器，在已配置的 DeepSeek 服务商下选择模型。请以当前界面的可用列表为准，不要照抄旧截图中的模型名称。
选择模型同时会把它设为新 Session 的默认模型；已经发过请求的 Session 会保留自己日志里记录的模型，因此修改默认模型不会自动改写旧对话。
发送一次测试请求
选择测试工作区，创建新会话并发送：
如果模型正常返回回答，说明本次请求使用的服务商配置有效。如果输入框不可用，先确认工作区和模型都已经选中。
自定义服务商最容易卡住的细节
Provider ID 是永久标识
使用小写 Provider ID。Session、默认模型和凭证引用都会用到它；需要改名时应新增一个服务商，再删除旧服务商。
apiKeyEnv 是变量名
YAML 里的 apiKeyEnv 写的是“保存 Key 的环境变量名称”，不是直接写密钥。DSH 在启动时继承环境变量；新增或修改变量后需要从正确的 Shell 重启 DSH。
Fetch models 会请求 GET /models
有些 OpenAI-compatible 网关能正常 Chat，但没有模型发现接口。确认 Base URL 和 Key 后，可以手动录入模型 ID。
按具体模型确认图片能力
手工添加的模型默认按纯文本处理，除非配置明确声明图片输入。内置模型的能力取决于已安装的 DSH 版本与模型目录，不能把所有 DeepSeek 模型视为相同输入能力。修改自定义模型前，先查看图片输入配置指南。
常见错误
MISSING_CREDENTIAL
返回 Settings → Models，重新保存当前 Session 使用的服务商凭证。使用 apiKeyEnv 时，确认对应环境变量在 DSH 启动前就已存在。
UNKNOWN_MODEL
选择当前确实存在于已配置服务商下的模型，或在自定义服务商里补充该模型。
401 / authentication failed
确认粘贴的是有效 API Key。若 401 出现在 Fetch available models，这是模型发现请求失败，不等同于 Chat 请求一定失败。
模型发现失败
检查凭证和 Base URL。如果自定义服务商不提供 GET /models，请手动输入模型 ID。
图片在发送请求前就被拒绝
先确认当前安装版本中的所选模型是否声明了图片输入。自定义视觉模型只有在端点确实支持图片时，才应添加 input: [text, image]。该声明只是允许附件通过，并不会给模型增加视觉能力。
输入框提示 Select model
选择当前已配置的服务商和模型。如果默认模型引用了一个已删除的服务商，也会出现这个状态。
Key 和 URL 都对，但网关仍拒绝所有请求
部分 OpenAI-compatible 网关不接受 OpenAI 的请求细节，例如 developer role 或 max_completion_tokens。请参考官方 Provider Guide 的 compat 配置，不要继续随机更换模型名或 Key。