DeepSeek API 接入教程：从注册到 Python 调用实战
从年初 DeepSeek-R1 开源到如今 V3 版本持续迭代，DeepSeek 已经成为很多开发者的主力模型之一。无论你是想为个人项目添加智能对话能力，还是为企业应用接入大模型，DeepSeek 官方 API 都提供了低门槛、高性能的调用方案。这篇教程会从零开始，带你完成从账号注册到 Python 调用的全过程，并提供一个可直接运行的聊天示例。
## 1. 注册并获取 API Key
首先你需要一个 DeepSeek 开放平台账号。访问 [platform.deepseek.com](https://platform.deepseek.com)，可以选择手机号或邮箱注册，按提示完成实名认证（个人开发者使用身份证即可，审核很快）。
登录后进入「API Keys」页面，点击「创建新的 API Key」，系统会生成一串以 `sk-` 开头的密钥。**请立即复制并保存**，这个页面关闭后将无法再次查看完整密钥。建议把 Key 存入环境变量或密码管理器，不要硬编码在代码中。
## 2. 理解计费与模型选择
DeepSeek 提供对话模型和代码模型，其中最常用的 `deepseek-chat` 对应 V3 版本，兼顾推理能力与成本。目前官方定价为：
- 输入：每百万 tokens 约 ¥1 元 - 输出：每百万 tokens 约 ¥2 元
新注册用户通常会赠送一定额度的免费 tokens，足够前期测试使用。你可以在平台的 Usage 页面随时查看消耗和余额，充值支持微信和支付宝。
## 3. 安装 Python SDK
DeepSeek 提供了官方的 Python 客户端，安装非常方便：
```bash pip install openai ```
没错，就是 OpenAI 的 Python 库。DeepSeek API 在接口设计上完全兼容 OpenAI 的 Chat Completions 规范，这意味着你甚至不需要额外安装任何第三方库。如果你已经在项目中使用 OpenAI SDK，只需修改 `base_url` 和 `api_key` 即可无缝切换。
## 4. 安全配置 API Key
建议通过环境变量存储密钥，避免直接写在代码中导致泄露。在终端中设置：
```bash export DEEPSEEK_API_KEY="你的sk-开头的密钥" ```
也可以将上面的命令写入 `~/.bashrc` 或 `~/.zshrc` 文件，使其永久生效。
## 5. Python 调用实战
下面是一个完整的聊天对话示例，它会向模型询问一个简单的技术问题，并打印流式返回的结果。
```python import os from openai import OpenAI
# 初始化客户端，指向 DeepSeek 服务地址 client = OpenAI( api_key=os.getenv("DEEPSEEK_API_KEY"), base_url="https://api.deepseek.com" )
# 构建对话消息 messages = [ {"role": "system", "content": "You are a helpful assistant."}, {"role": "user", "content": "请用 Python 实现快速排序算法"} ]
# 发起请求，开启流式输出 response = client.chat.completions.create( model="deepseek-chat", messages=messages, stream=True )
# 逐块接收并打印回复内容 for chunk in response: delta = chunk.choices[0].delta if delta.content: print(delta.content, end="", flush=True) ```
运行这段脚本，终端会像 ChatGPT 一样逐字打印排序算法的代码和解释。如果你想一次性获取完整回复，只需将 `stream=True` 移除，然后通过 `response.choices[0].message.content` 获取完整文本。
## 6. 参数调优与进阶用法
在实际开发中，你可以通过以下参数精细控制生成效果：
- `temperature`：0～2，值越高输出越随机，代码生成建议设为 0。 - `max_tokens`：单次生成的最大 token 数，防止费用失控。 - `top_p`：核采样参数，推荐与 temperature 二选一使用。
除了对话生成，DeepSeek API 也支持 Function Calling、JSON Mode 等高级功能，具体用法与 OpenAI 接口完全一致，参照官方文档即可快速上手。
## 7. 如果你想统一管理多个模型
随着项目迭代，你可能需要同时使用 DeepSeek、Qwen、Claude、Gemini 等不同厂商的模型。此时逐个注册、充值、管理 Key 会变得繁琐。一个不错的方案是使用 API 中转站，一次接入即可调用多款热门模型，按量计费且无需担心额度过期。
这里推荐 [TokenPocket API 中转站](https://tokenpocket.site)，它已接入 DeepSeek、千问、Claude、Gemini 等主流模型，接口同样兼容 OpenAI 格式，你只需把 `base_url` 换成中转站地址。支持 USDT 直接支付，充值门槛低，新用户注册还会自动赠送免费额度，方便你在正式使用前进行充分测试。对于需要频繁切换模型、不想维护多个供应商账户的开发者来说，这是一个很省心的选择。