DeepSeek API Key怎么获取和配置?完整教程(2025最新)

什么是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_urlhttps://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资讯和实用教程。