DeepSeek API Key 获取与 UniterRouter 配置核验
简答：获取 DeepSeek API Key 的最短路径是：打开 <a href="https://platform.deepseek.com/">DeepSeek Platform 控制台</a>创建密钥，保存到环境变量，用 <code>https://api.deepseek.com/</code> 和 Bearer 鉴权完成一次直连请求。接入 UniterRouter 时，当前公开首页能核实其客户端 Base URL 为 <code>https://api.uniterouter.cyou/v1</code>、环境变量示例为 <code>UNITEROUTER_API_KEY</code>；但 provider key、DeepSeek 模型映射和计费归属不能仅凭首页确认，应先直连验证，再按控制台当前字段填写。
定义：DeepSeek API Key 是放在 <code>Authorization: Bearer</code> 请求头中、用于调用 DeepSeek API 的访问凭证；它不等同于兼容网关向客户端签发的 API Key。
先看速查卡：30 秒判断该填哪把 Key
本文是第三方 AI API 接入指南，不是 DeepSeek 或 UniterRouter 官方页面。截至 2026 年 10 月 30 日，下面只采用 DeepSeek 官方文档和 UniterRouter 当前公开首页能够核实的内容。
| 项目 | 直连 DeepSeek | UniterRouter |
|---|---|---|
| 请求地址 | https://api.deepseek.com/chat/completions | 公开首页示例为 https://api.uniterouter.cyou/v1，实际路径以当前控制台或文档为准 |
| 客户端 Key | DeepSeek API Key | 公开首页示例使用 UNITEROUTER_API_KEY；不能据此推断 provider 配置规则 |
| 模型 | 从官方 /models 响应或当前文档复制 | 必须从网关当前模型列表或控制台复制，不能直接假设使用 DeepSeek 模型 ID |
| 计费归属 | 检查 DeepSeek 控制台余额与用量 | 公开首页未说明 DeepSeek provider 余额、网关费用和路由计费层级，需查看当前控制台、账单或服务条款 |
| 成功判定 | 返回 JSON 且 choices[0].message.content 有内容 | 除返回模型内容外，还要在网关用量或请求记录中核对路由信息；若页面没有该记录，不能仅凭响应断定实际 provider |
推荐顺序：先用官方 API 完成一次非流式最小请求；再配置网关。这样可以把“DeepSeek Key 无效”和“网关字段填错”分开。
获取 DeepSeek API Key：官方入口、创建和保存
- 打开 DeepSeek Platform 控制台。DeepSeek API 文档的 API Key 入口直接指向该控制台；文档站用于查看接口，控制台用于登录、创建和管理密钥。
- 登录或注册后，在当前控制台寻找 API Key、API Keys 或创建密钥入口。菜单文字可能随控制台调整，以当前页面为准。
- 创建密钥后立即复制并保存到密码管理器或服务端密钥管理系统。若当前页面只展示一次完整密钥，应在离开页面前保存；不要假设关闭页面后一定能够再次查看。
- 不要把 Key 放进浏览器前端、公开仓库、截图、客户端安装包或完整错误日志。Bash/zsh 可执行
export DEEPSEEK_API_KEY='你的真实密钥'；PowerShell 可执行$env:DEEPSEEK_API_KEY='你的真实密钥'。 - 如果密钥已经暴露，停止使用并回到控制台撤销或轮换，再用新密钥测试。余额和权限也要单独核对；官方错误码文档将 402 定义为余额不足。
DeepSeek API 的认证方式是 HTTP Bearer Auth，官方首次调用文档将 OpenAI 兼容 Base URL 列为 https://api.deepseek.com。可分别查看 DeepSeek API 认证参考 和 官方首次调用文档。
先完成官方直连：curl、Python 和 JavaScript 最小示例
当前官方文档和 Models 接口示例列出 deepseek-flash 与 deepseek-v4-pro。其中 deepseek-flash 当前由官方文档说明对应 DeepSeek-V4.1-Flash-1017；发布前或实际调用时，仍应优先请求 /models 复制当前可用 ID。模型列表说明见 DeepSeek Lists Models API。
curl
curl --connect-timeout 10 --max-time 60 "https://api.deepseek.com/chat/completions" -H "Content-Type: application/json" -H "Authorization: Bearer ${DEEPSEEK_API_KEY}" -d '{"model":"deepseek-flash","messages":[{"role":"user","content":"Hello"}],"stream":false}'
Python
pip install openai
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["DEEPSEEK_API_KEY"],
base_url="https://api.deepseek.com",
)
response = client.chat.completions.create(
model="deepseek-flash",
messages=[{"role":"user", "content":"Hello"}],
stream=False,
)
print(response.choices[0].message.content)
Node.js
npm install openai
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.DEEPSEEK_API_KEY,
baseURL: "https://api.deepseek.com",
});
const response = await client.chat.completions.create({
model: "deepseek-flash",
messages: [{ role: "user", content: "Hello" }],
stream: false,
});
console.log(response.choices[0].message.content);
成功判定：HTTP 请求返回 JSON，且响应中存在可读取的模型输出。首次排查先关闭流式、缩短输入、只保留一个用户消息；日志只保留状态码、路径和脱敏错误，不记录 Authorization 请求头。
UniterRouter 配置核验：已确认内容与不能猜的字段
UniterRouter 当前公开首页展示了 OpenAI SDK 兼容方式、客户端环境变量 UNITEROUTER_API_KEY，以及 https://api.uniterouter.cyou/v1 这个 Base URL；首页示例使用 chat.completions.create 调用。可查看 UniterRouter 当前公开首页复核这些展示内容。
但截至本文核验时，UniterRouter 文档入口无法稳定取得可验证的 provider 配置页面，因此以下内容必须视为待确认项，不能当作已完成的 DeepSeek 配置教程：
- 控制台中添加 provider 的菜单名称和具体路径；
- DeepSeek provider key 的字段名、保存方式和验证按钮；
- 网关是否要求单独填写 DeepSeek Base URL；
- 网关内部使用的 DeepSeek 模型 ID、别名或路由名称；
- 请求由谁计费、provider 余额是否单独计算，以及用量数据是否完整；
- 是否支持 Responses API、流式事件、额外推理参数或完整 usage 字段。
可照做的核验顺序：①在 UniterRouter 当前控制台创建或复制客户端 Key；②复制控制台给出的 Base URL；③确认是否存在 Providers、BYOK、Provider Keys 或类似页面；④若要求填写 DeepSeek Key，只在明确的 provider 配置页提交；⑤从当前模型列表复制模型 ID；⑥先发一条非流式短请求；⑦在请求记录、用量或账单页面核对是否出现对应调用。
网关 curl 模板：只替换控制台明确给出的值
curl --connect-timeout 10 --max-time 60 "https://api.uniterouter.cyou/v1/chat/completions" -H "Content-Type: application/json" -H "Authorization: Bearer ${UNITEROUTER_API_KEY}" -d '{"model":"MODEL_ID_FROM_UNITEROUTER","messages":[{"role":"user","content":"Hello"}],"stream":false}'
这里的 MODEL_ID_FROM_UNITEROUTER 是占位符，不是已核实的 DeepSeek 模型名。只有当 UniterRouter 当前控制台明确给出该模型 ID 时才替换；若返回 404 或模型不存在，先回到模型列表核对，不要继续更换真实 Key。
401、402、404、429：按响应分流，不要盲目重试
| 现象 | 先查什么 | 处理方式 |
|---|---|---|
| 401 | Key 是否为空、Bearer 格式、环境变量和请求地址 | 重新读取环境变量；确认直连时用 DeepSeek Key、网关时用网关客户端 Key；认证失败不要无限重试 |
| 402 | DeepSeek 官方账户余额 | 查看官方控制台余额和充值状态；不要把 402 当成模型不存在 |
| 404 | Base URL、路径或模型 ID | 分别核对当前服务给出的 URL、/chat/completions 路径和模型列表；网关 404 不能直接归因 DeepSeek |
| 422 | 参数是否被当前协议接受 | 删除未确认字段，使用官方最小请求 |
| 429 | 请求速度、并发、QPS 和响应中的 Retry-After | 仅对临时限流做有限指数退避，设置总时限；余额、权限和未知错误不要自动重试 |
| 500/503 | 服务端或过载信息 | 短暂等待后有限重试；保留时间、状态码和脱敏响应 |
DeepSeek 官方错误码页面将 401、402、422、429、500 和 503 分别对应认证失败、余额不足、参数无效、限流、服务端错误和过载；并发限制按账户计算，而不是简单按 API Key 分开计算，详情见 官方错误码文档 和 官方限流与隔离文档。
发布前检查清单
- 入口：创建 Key 时使用 DeepSeek Platform 控制台，不要把聊天网页或第三方教程页当成密钥管理入口。
- 凭证：直连使用 DeepSeek API Key；网关请求使用网关当前控制台规定的客户端 Key，二者不要混用。
- 模型：优先从
GET /models或当前服务模型列表复制，不凭旧文章猜测。 - 网关：provider key、Base URL、模型映射和计费层级没有明确页面支持时，标记为未核实，不向未知页面提交真实密钥。
- 验证：先非流式、短输入、单轮请求，再启用流式、工具调用或额外参数。
- 停止条件：401 持续出现就停止重试并检查或轮换 Key；402 先处理余额；404 先核对地址、路径和模型；429 先降低并发并查看响应。
常见问题
DeepSeek API Key 官方入口在哪里？
使用 DeepSeek Platform 控制台创建和管理。DeepSeek API 文档中的 API Key 链接也指向该控制台；文档站主要用于查认证、Base URL、模型和请求格式。
DeepSeek API Key 和 UniterRouter API Key 是同一个吗？
不是。DeepSeek API Key 用于直连 DeepSeek；UniterRouter 首页展示的是客户端环境变量 UNITEROUTER_API_KEY。网关是否还需要单独配置 DeepSeek provider key，必须以当前控制台字段为准。
为什么创建 Key 后返回 402？
DeepSeek 官方将 402 定义为余额不足。创建密钥只说明凭证生成，不代表账户余额或调用权限已经满足要求，请检查官方控制台余额和充值状态。
为什么网关请求返回 404？
先检查网关当前 Base URL 是否包含正确版本路径，再核对 /chat/completions 和模型 ID。不要直接把网关 404 归因于 DeepSeek，也不要在未确认模型映射前反复更换 Key。
可以直接照抄旧教程里的模型名吗？
不建议。当前官方 Models 接口提供可用模型 ID 和能力元数据，发布前应重新请求或从当前文档复制。本文示例使用官方当前页面展示的 deepseek-flash，但网关内部是否接受同名字段仍需单独核验。
如何确认请求真的路由到了 DeepSeek？
直连时，Base URL、模型列表和官方账户用量可以作为核验线索；通过 UniterRouter 时，还应查看网关请求记录、路由信息、模型映射或账单页面。若公开页面没有提供这些记录，单凭模型输出不能证明实际 provider。
常见问题
DeepSeek API Key 官方入口在哪里？
使用 DeepSeek Platform 控制台创建和管理；API 文档用于查看认证、Base URL、模型和请求格式。
DeepSeek API Key 和 UniterRouter API Key 是同一个吗？
不是。直连 DeepSeek 使用 DeepSeek API Key；UniterRouter 首页展示客户端环境变量 UNITEROUTER_API_KEY。provider key 是否还要单独配置，必须看当前控制台。
创建 Key 后为什么返回 402？
DeepSeek 官方将 402 定义为余额不足，请检查官方控制台余额、充值状态和调用权限。
UniterRouter 返回 404 怎么排查？
核对当前 Base URL、/chat/completions 路径和模型 ID。不要把网关 404 直接归因于 DeepSeek，也不要盲目更换 Key。
如何确认请求是否真正到达 DeepSeek？
直连可检查 DeepSeek 官方用量；通过网关还应查看请求记录、路由信息、模型映射或账单。仅凭模型输出无法证明实际 provider。
相关阅读
- 对照阅读：Anthropic API Key 获取与 401 排查
- 下一步：把兼容 API 接入 Claude Code
- 工具配置参考：在 Cursor 中核对 Base URL 和 Key
- 查看更多 API 接入与错误排查指南
参考资料
- DeepSeek 官方文档：Your First API Call（api-docs.deepseek.com）
- DeepSeek 官方 API 参考：认证方式（api-docs.deepseek.com）
- DeepSeek 官方 API 参考：Lists Models（api-docs.deepseek.com）
- DeepSeek 官方文档：Error Codes（api-docs.deepseek.com）
- DeepSeek 官方文档：Rate Limit & Isolation（api-docs.deepseek.com）
- DeepSeek Platform 官方控制台（platform.deepseek.com）
- UniterRouter 当前公开首页