DeepSeek API Key 怎么获取？创建、保存与首次调用步骤
简答：DeepSeek API Key 需要在 DeepSeek API 平台创建，不是网页版登录密码。最短路径是：打开官方 API 文档中的“create an API key”入口→创建并立即复制密钥→保存为 DEEPSEEK_API_KEY→使用官方 Base URL https://api.deepseek.com/ 发送一次非流式请求。本文只覆盖 Key 的获取、保存、配置和首次调用；具体余额、价格与模型以当前官方页面为准。
定义：DeepSeek API Key 是用于通过 Bearer Token 访问 DeepSeek API 的密钥，与网页版账号密码用途不同。
先看这张配置卡：获取 Key 到跑通请求
适用范围：需要通过 OpenAI 兼容格式调用 DeepSeek API 的开发者。不覆盖：网页版登录、多个客户端的完整配置、流式响应优化和第三方平台的专属设置。
| 项目 | 应填写什么 | 官方核验位置 |
|---|---|---|
| API Key | 在 API 平台创建的密钥，示例值，不要照抄 | DeepSeek API 文档 |
| 认证方式 | Authorization: Bearer YOUR_KEY | Authentication |
| OpenAI 兼容 Base URL | https://api.deepseek.com | Your First API Call |
| 模型 | deepseek-flash为当前文档示例值，发送前核对模型页 | Models & Pricing |
- 进入官方 API 文档，点击其中的 API Key 创建入口。页面菜单名称可能变化，不要把网页版登录密码当作 API Key。
- 创建密钥后立即复制，并放入本地密码管理器或受权限保护的环境变量中。不要把完整 Key 发到聊天、截图、前端代码或 Git 仓库。
- 设置环境变量后，使用下面的最小非流式请求验证四项结果：HTTP 状态为成功、响应包含可解析的
choices、其中有实际文本、客户端或终端显示模型返回内容。
如何安全保存 DEEPSEEK_API_KEY
官方快速入门要求在运行示例前设置 DEEPSEEK_API_KEY 环境变量。下面是类 Unix 终端的短步骤；输入内容不会直接写在命令文本中，但这不等于系统凭据管理或生产环境密钥托管。
- 执行
read -s DEEPSEEK_API_KEY，粘贴密钥后按回车。 - 执行
export DEEPSEEK_API_KEY，让当前终端会话可以读取它。 - 确认程序只读取变量名，不要执行打印完整密钥的诊断命令。
- 终端关闭后重新设置；生产环境应改用平台的 Secret、凭据管理器或受限权限的环境文件。
如果密钥已经出现在公开仓库、日志或截图中，应优先在 API 平台撤销或轮换，再更新应用配置。由于密钥权限和控制台操作可能随平台调整，撤销入口请以当前 API 平台页面为准。
最小 curl 请求：只验证 Key、地址和模型
以下命令适用于 Bash、Zsh 等类 Unix shell。DEEPSEEK_API_KEY 是环境变量名，不是要原样发送的密钥；模型名属于示例值，运行前请与当前官方模型页面核对。
curl 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}'
成功判定：第一，HTTP 响应不是认证或余额错误；第二，JSON 能正常解析；第三，响应中出现 choices；第四，choices[0].message.content 或当前响应结构中的文本字段有实际内容。不要只看命令是否结束，也不要把 HTTP 200 当作业务文本一定正确。
官方示例还展示了 OpenAI Python 和 Node.js SDK 的调用方式；如果你使用 SDK，应先按当前 SDK 文档安装，并核对该版本的参数写法，不要把不同 SDK 的配置字段混用。
DeepSeek API Key 常见错误怎么判断
| 错误 | 官方定义 | 先做什么 |
|---|---|---|
| 401 | Authentication Fails，通常是 API Key 错误 | 确认环境变量实际被程序读取，重新复制 Key，检查是否多了空格；不要先改模型名。 |
| 402 | Insufficient Balance，余额用尽 | 登录 API 平台查看余额并按官方页面处理充值；不要把它当作 Key 格式错误。 |
| 422 | Invalid Parameters，请求参数无效 | 检查 JSON、字段名、模型和参数类型，并阅读响应体提示。 |
| 429 | Rate Limit Reached，请求过快或超过并发/QPS 限制 | 降低并发和请求频率，按当前限流文档核对账户级限制。 |
| 500/503 | 服务端错误或服务过载 | 短暂等待后重试；持续发生时保留状态码、响应体和请求时间联系官方支持。 |
这些是官方文档列出的定义，不代表每个客户端都会以相同界面显示。排查顺序建议固定为：凭据→最终 URL 和路径→模型→权限或余额→最小请求→错误响应体。
是否需要充值？模型和价格怎么核对
首次调用是否能成功，除了 Key 和请求格式，还可能受账户余额影响；官方错误码将 402 定义为余额不足。余额、模型、价格和限流都属于动态信息，发布前或实际调用前应直接查看官方页面，不要依据旧教程中的模型名或价格。
当前官方快速入门把 deepseek-flash 作为模型名示例，并说明旧名称的处理方式；模型页同时列出模型版本、上下文长度、功能和计费信息。若你的控制台或响应提示模型不存在，应以当前模型页面和控制台可用模型为准，不要自行拼接模型 ID。
把 DeepSeek Key 填入第三方工具前的核对清单
- 协议：工具是否支持 OpenAI 兼容接口，而不是只接受某一家厂商的专有协议。
- Base URL：OpenAI 兼容配置使用官方文档列出的地址；如果工具会自动追加路径，先确认它不会重复拼接。
- Key 字段：粘贴 API Key，不要粘贴网页版密码、Bearer 前缀或带引号的整行配置，除非工具明确要求。
- 模型：从当前官方模型页或工具可识别列表复制，示例模型不可视为永久有效。
- 日志：开启排错时只保留状态码、请求路径和脱敏后的响应，不记录完整 Authorization 头。
本站是独立的 AI API 接入指南站，不是 DeepSeek 官方站点；品牌参数、控制台入口和可用模型均应以官方资料为准。
常见问题
DeepSeek API Key 在哪里获取？
从 DeepSeek API 文档中的 API Key 创建入口进入 API 平台创建。入口名称或控制台布局可能变化，建议从当前官方文档点击，而不是使用搜索结果中的未知跳转链接。
DeepSeek API Key 和网页版密码一样吗？
不一样。API Key 用于程序通过 Bearer Token 调用 API；网页版密码用于账号登录。不要把登录密码填进 API 客户端的 Key 字段。
为什么刚创建 Key 就返回 401？
先确认程序读取的是最新 Key，环境变量没有为空、带额外空格或被旧会话覆盖；再检查最终请求是否包含正确的 Bearer Authorization。仍失败时查看官方响应体并重新创建或轮换密钥。
为什么返回 402？
官方将 402 定义为余额不足。请到 API 平台查看账户余额和充值入口；这不是单纯更换模型或重复创建 Key 就能解决的问题。
deepseek-flash 还能直接使用吗？
当前官方快速入门将 <code>deepseek-flash</code>列为模型名示例，并说明其对应的模型版本。由于模型和计费可能调整，发送请求前仍应以当前官方 Models & Pricing 页面为准。
相关阅读
参考资料
- DeepSeek API 文档：创建 API Key 与 Bearer 鉴权（api-docs.deepseek.com）
- DeepSeek API 文档：首次调用、Base URL、模型与示例（api-docs.deepseek.com）
- DeepSeek API 文档：错误码定义与处理建议（api-docs.deepseek.com）