在 Chatbox 中接入 DeepSeek 官方 API:配置、请求验证与报错排查

6 阅读6分钟

在 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

  1. 打开 DeepSeek 开放平台的 API Keys 页面。
  2. 登录后创建 API Key,按页面提示保存。
  3. 确认开放平台账号有足够的可用余额。

API 调用按 DeepSeek 开放平台规则计费,不能把“可以在网页聊天”理解为“API 一定有可用额度”。使用自带 DeepSeek Key 时,模型 API 用量由 DeepSeek 侧计量扣费;Chatbox AI 服务额度不能替代 DeepSeek API 余额。

不要把完整 API Key 放进公开文章、截图、代码仓库或评论区。如果意外泄露,请在开放平台撤销该 Key,并创建新 Key。

三、推荐方式:使用 Chatbox 内置的 DeepSeek 提供方

先从 Chatbox 官网 下载安装客户端。

按照 Chatbox 官方 DeepSeek 配置指南,操作如下:

image.png

  1. 打开 Chatbox,点击左下角的 设置。
  2. 在设置左侧选择 模型提供方,找到 DeepSeek。
  3. 将 DeepSeek 开放平台创建的 Key 粘贴到 API Key 字段。
  4. 点击 检查,确认连接测试成功。
  5. 返回对话界面,在模型列表中选择当前可用的 DeepSeek 模型。

移动端先点击左上角菜单展开侧边栏,再打开设置。

内置提供方通常不需要你手动填写 Host。 如果教程读者只是想开始聊天,先完成这条路径即可。

新建一段对话,发送下面的问题测试:

请用三句话解释什么是 API,并举一个日常使用的例子。

检查所选提供方和模型是否正确,并确认能收到回复。本文未使用真实密钥执行付费调用;以上步骤依据 Chatbox 和 DeepSeek 当前官方文档整理。

四、需要手动配置时,Host 应该填什么?

如果你的版本需要自定义提供方,或你想了解手动接入方式,可在 设置 → 模型提供方 中添加自定义提供方,选择 OpenAI 兼容的接口类型。不同版本按钮名称可能略有差异。

字段填写内容
提供方名称DeepSeek 官方 API(自定义名称)
接口类型OpenAI 兼容
API Host / Base URLhttps://api.deepseek.com
API Key你在 DeepSeek 开放平台创建的 Key
模型 IDdeepseek-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请求体格式错误是否修改了请求格式或加入不兼容参数
401API Key 错误,认证失败是否复制完整、是否混入空格、是否用了其他平台的 Key
402账号余额不足DeepSeek 开放平台的可用余额
422请求体参数错误模型 ID、参数名称和值,结合返回的具体错误定位
429请求速率或并发达到上限减少同时请求,调整调用频率
500服务器内部故障等待后重试;持续出现时联系官方
503服务器负载过高稍后重试

如果只是提示网络连接失败,还要检查本机网络、代理配置和报错详情。不要在不了解错误原因时,反复更换来历不明的 API Host。

七、接入其他 API 时,也按这三项信息核对

换成其他模型平台,流程通常仍是:创建该平台的 API Key → 查官方支持的协议和 Base URL → 选择官方模型 ID → 在客户端验证。

OpenAI 兼容并不意味着所有参数和功能都完全相同。接入新服务前,分别确认密钥来源、地址和模型,不要把不同平台的字段混用。

官方参考与参数依据

本文信息官方依据
Chatbox 内置 DeepSeek 的设置路径、连接检查Chatbox:DeepSeek 配置指南