什么是DeepSeek API Key?为什么需要它
红烁AI 培训,红烁 AI 中转站为您整理:DeepSeek是由深度求索(DeepSeek)公司推出的高性能大语言模型系列,凭借出色的推理能力和极具竞争力的价格,迅速成为开发者社区的热门选择。DeepSeek API Key是访问其云端模型服务的唯一凭证,相当于你账户的”通行证”。
每一次API调用都需要携带这个Key进行身份验证。没有它,你的程序无法与DeepSeek的模型通信。因此,正确获取和安全配置DeepSeek API Key,是使用DeepSeek开发的第一步。
目前DeepSeek开放平台支持的主要模型包括:
- deepseek-chat:通用对话模型,适合问答、写作、代码生成等场景
- deepseek-reasoner:强化推理模型(R1系列),适合数学、逻辑、复杂分析任务
两个模型均通过同一套API接口调用,切换成本极低,非常适合在项目中灵活组合使用。
DeepSeek API Key获取步骤(图文详解)
第一步:注册DeepSeek开放平台账号
打开浏览器,访问 platform.deepseek.com,点击右上角「注册」按钮。目前支持手机号或邮箱注册,国内用户推荐使用手机号,验证更快捷。填写基本信息并完成短信验证后,账号即创建成功。
第二步:进入API Key管理页面
登录后,点击左侧导航栏中的「API Keys」选项,进入密钥管理页面。如果是首次使用,页面会提示你当前没有任何Key,需要手动创建。
第三步:创建新的API Key
点击「创建 API Key」按钮,在弹出的对话框中为这个Key填写一个便于识别的名称,例如「my-project-dev」或「test-key」。命名建议与你的项目或用途对应,方便后续管理多个Key。
点击确认后,系统会生成一串以 sk- 开头的字符串,这就是你的DeepSeek API Key。请务必在此时复制并妥善保存,因为出于安全原因,该Key只会完整显示一次,关闭弹窗后将无法再次查看完整内容。
第四步:充值余额(按需)
DeepSeek API采用按量计费模式。新注册用户通常会获得一定额度的免费试用Token,可以直接用于测试。如需正式使用,在「充值」页面选择金额完成支付即可,费用会实时从余额中扣除。
DeepSeek API Key配置方法
方法一:配置为环境变量(推荐)
将API Key硬编码在代码中是非常危险的做法,一旦代码上传到GitHub等公开仓库,Key就会泄露。最佳实践是将其存储为环境变量。
Linux / macOS:
# 临时生效(当前终端会话)
export DEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxxxx"
# 永久生效(写入 ~/.bashrc 或 ~/.zshrc)
echo 'export DEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc
Windows(PowerShell):
# 临时生效
$env:DEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxxxx"
# 永久生效(写入用户环境变量)
[System.Environment]::SetEnvironmentVariable("DEEPSEEK_API_KEY","sk-xxxxxxxxxxxxxxxx","User")
方法二:使用.env文件管理
在项目根目录创建 .env 文件,写入以下内容:
DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxx
同时在 .gitignore 中添加 .env,确保该文件不会被提交到版本控制系统。Python项目可以使用 python-dotenv 库自动加载,Node.js项目可以使用 dotenv 包。
实际调用示例
Python调用示例
DeepSeek API与OpenAI SDK完全兼容,只需修改 base_url 即可无缝切换。
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ.get("DEEPSEEK_API_KEY"),
base_url="https://api.deepseek.com"
)
response = client.chat.completions.create(
model="deepseek-chat",
messages=[
{"role": "system", "content": "你是一个专业的技术助手"},
{"role": "user", "content": "用Python写一个快速排序算法"}
],
temperature=0.7
)
print(response.choices[0].message.content)
Node.js调用示例
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-chat",
messages: [
{ role: "user", content: "解释一下什么是递归" }
],
});
console.log(response.choices[0].message.content);
使用curl直接测试
不想写代码?用curl快速验证Key是否有效:
curl https://api.deepseek.com/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $DEEPSEEK_API_KEY" \
-d '{
"model": "deepseek-chat",
"messages": [{"role": "user", "content": "你好"}]
}'
如果返回包含 choices 字段的JSON响应,说明Key配置完全正确。
常见问题FAQ
Q:API Key泄露了怎么办?
立即登录DeepSeek开放平台,进入「API Keys」页面,找到对应的Key并点击「删除」。然后重新创建一个新Key,更新到你的项目配置中。动作要快,泄露的Key可能被他人盗用消耗余额。
Q:调用时报401错误是什么原因?
401错误表示身份验证失败,常见原因有三个:Key填写有误(注意不要有多余空格)、Key已被删除或过期、请求头中 Authorization 格式不正确(正确格式为 Bearer sk-xxx,注意Bearer后有一个空格)。
Q:免费额度用完后如何查看余额?
登录平台后,在「用量」或「账单」页面可以查看当前余额和历史消耗明细,支持按日期筛选,方便核对费用。
Q:一个账号可以创建多少个API Key?
目前DeepSeek平台支持创建多个API Key,建议为不同项目或环境(开发、测试、生产)分别创建独立的Key,便于权限隔离和用量追踪。
Q:DeepSeek API和OpenAI API可以共用同一套代码吗?
可以。DeepSeek API完全兼容OpenAI的接口规范,只需将 base_url 从 https://api.openai.com 改为 https://api.deepseek.com,并替换对应的API Key,其余代码无需改动。
总结
获取和配置DeepSeek API Key的整个流程并不复杂:注册账号→创建Key→配置环境变量→调用API,四步即可完成。关键点在于两件事:Key只显示一次,创建后立即保存;永远不要将Key明文写入代码或提交到代码仓库。
掌握这些基础之后,你就可以开始探索DeepSeek在对话、代码生成、文档分析、智能体构建等方向的丰富应用场景了。如果你在配置过程中遇到问题,可以参考DeepSeek官方文档(docs.deepseek.com)获取最新的接口说明和错误码解释。
想了解更多AI工具和技巧?欢迎访问红烁AI 培训,红烁 AI 中转站,获取最新AI资讯和实用教程。
