在 Chatbox 中接入 DeepSeek 官方 API:配置、请求验证与报错排查
想在 Chatbox 中使用自己的 DeepSeek API Key,需要配置哪些信息?API Host 应该填官网地址,还是完整接口地址?
这篇教程以 DeepSeek 官方 API + Chatbox 为例,介绍无需编程的接入流程,并补充可选的命令行验证方法。API 地址、模型 ID 和错误码均附有 DeepSeek 官方文档链接。
一、先理解 API Key、Host 和模型 ID
把模型 API 接入客户端时,通常需要三项信息:
| 配置项 | 作用 | DeepSeek 示例 |
|---|---|---|
| API Key | 识别你的开放平台账号,用于 API 鉴权 | 在 DeepSeek 开放平台自行创建 |
| API Host / Base URL | 告诉客户端向哪个服务发送请求 | https://api.deepseek.com |
| 模型 ID | 指定本次调用使用哪个模型 | deepseek-flash |
DeepSeek 官方《首次调用 API》将 OpenAI 格式的 base_url 列为 https://api.deepseek.com,并提供 deepseek-flash、deepseek-v4-pro 两个模型名称。本文以 deepseek-flash 为例。
这里的“OpenAI 格式”是接口兼容格式,不是让你注册 OpenAI 或填写 OpenAI 的密钥。实际请求发送给 DeepSeek,密钥也来自 DeepSeek。
二、准备 DeepSeek API Key
- 打开 DeepSeek 开放平台的 API Keys 页面。
- 登录后创建 API Key,按页面提示保存。
- 确认开放平台账号有足够的可用余额。
API 调用按 DeepSeek 开放平台规则计费,不能把“可以在网页聊天”理解为“API 一定有可用额度”。使用自带 DeepSeek Key 时,模型 API 用量由 DeepSeek 侧计量扣费;Chatbox AI 服务额度不能替代 DeepSeek API 余额。
不要把完整 API Key 放进公开文章、截图、代码仓库或评论区。如果意外泄露,请在开放平台撤销该 Key,并创建新 Key。
三、推荐方式:使用 Chatbox 内置的 DeepSeek 提供方
先从 Chatbox 官网 下载安装客户端。
按照 Chatbox 官方 DeepSeek 配置指南,操作如下:
- 打开 Chatbox,点击左下角的 设置。
- 在设置左侧选择 模型提供方,找到 DeepSeek。
- 将 DeepSeek 开放平台创建的 Key 粘贴到 API Key 字段。
- 点击 检查,确认连接测试成功。
- 返回对话界面,在模型列表中选择当前可用的 DeepSeek 模型。
移动端先点击左上角菜单展开侧边栏,再打开设置。
内置提供方通常不需要你手动填写 Host。 如果教程读者只是想开始聊天,先完成这条路径即可。
新建一段对话,发送下面的问题测试:
请用三句话解释什么是 API,并举一个日常使用的例子。
检查所选提供方和模型是否正确,并确认能收到回复。本文未使用真实密钥执行付费调用;以上步骤依据 Chatbox 和 DeepSeek 当前官方文档整理。
四、需要手动配置时,Host 应该填什么?
如果你的版本需要自定义提供方,或你想了解手动接入方式,可在 设置 → 模型提供方 中添加自定义提供方,选择 OpenAI 兼容的接口类型。不同版本按钮名称可能略有差异。
| 字段 | 填写内容 |
|---|---|
| 提供方名称 | DeepSeek 官方 API(自定义名称) |
| 接口类型 | OpenAI 兼容 |
| API Host / Base URL | https://api.deepseek.com |
| API Key | 你在 DeepSeek 开放平台创建的 Key |
| 模型 ID | deepseek-flash |
保存后获取或刷新模型列表;如果支持手动添加模型,按官方模型 ID 填写。若自定义入口与当前界面不同,请优先采用第三节的内置 DeepSeek 入口。
Base URL 和完整请求地址不要混淆
DeepSeek 官方示例中:
Base URL:https://api.deepseek.com
聊天请求地址:https://api.deepseek.com/chat/completions
/chat/completions 是聊天接口路径。在要求填写 Base URL / API Host 的字段中,填写基础地址,而不是直接复制整条聊天请求地址。 如果客户端分别提供基础地址和接口路径字段,则按字段含义分别配置。
官方还列出了 Anthropic 格式的基础地址 https://api.deepseek.com/anthropic。本文选择 OpenAI 兼容配置,不要将两种协议的地址混用。
模型 ID 不要照搬过期教程
截至本文核对日期,官方首页示例使用 deepseek-flash,模型与价格页也列出了 deepseek-v4-pro。模型 ID 是请求参数,应照官方文档填写,而不是根据产品显示名称自行拼写。
如果客户端的模型列表与官方文档不同,先刷新列表、检查客户端版本,再考虑手动添加当前模型。
五、可选:用 curl 判断问题出在 API 还是客户端
不熟悉命令行可以跳过这一节。熟悉终端的读者可以参考 DeepSeek 官方示例,独立验证 Key、余额和请求参数。
先在当前终端设置环境变量 DEEPSEEK_API_KEY,值为你自己的 Key。不要把真实 Key 写入将要发布的脚本。下面是基于官方首页 curl 样例整理的请求:
curl https://api.deepseek.com/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DEEPSEEK_API_KEY}" \
-d '{
"model": "deepseek-flash",
"messages": [
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "请用三句话解释什么是 API。"}
],
"thinking": {"type": "enabled"},
"reasoning_effort": "high",
"stream": false
}'
其中 Authorization: Bearer ...、请求地址、模型名称以及思考参数均取自 DeepSeek 官方首页调用示例。首次配置 Chatbox 时,无需为了照搬此示例而额外修改客户端的思考或高级参数。
如果命令行成功、Chatbox 失败,优先检查客户端的提供方类型、基础地址和模型 ID;如果命令行也失败,先看 DeepSeek 返回的状态码和错误信息。每次请求可能产生 API 费用。
六、常见错误怎么排查?
| 错误码 | DeepSeek 官方含义 | 建议先检查 |
|---|---|---|
| 400 | 请求体格式错误 | 是否修改了请求格式或加入不兼容参数 |
| 401 | API Key 错误,认证失败 | 是否复制完整、是否混入空格、是否用了其他平台的 Key |
| 402 | 账号余额不足 | DeepSeek 开放平台的可用余额 |
| 422 | 请求体参数错误 | 模型 ID、参数名称和值,结合返回的具体错误定位 |
| 429 | 请求速率或并发达到上限 | 减少同时请求,调整调用频率 |
| 500 | 服务器内部故障 | 等待后重试;持续出现时联系官方 |
| 503 | 服务器负载过高 | 稍后重试 |
如果只是提示网络连接失败,还要检查本机网络、代理配置和报错详情。不要在不了解错误原因时,反复更换来历不明的 API Host。
七、接入其他 API 时,也按这三项信息核对
换成其他模型平台,流程通常仍是:创建该平台的 API Key → 查官方支持的协议和 Base URL → 选择官方模型 ID → 在客户端验证。
OpenAI 兼容并不意味着所有参数和功能都完全相同。接入新服务前,分别确认密钥来源、地址和模型,不要把不同平台的字段混用。
官方参考与参数依据
| 本文信息 | 官方依据 |
|---|---|
| Chatbox 内置 DeepSeek 的设置路径、连接检查 | Chatbox:DeepSeek 配置指南 |