DeepSeek API 接入教程：从注册到 Python 调用实战
无论你是想为自己的应用接入大模型，还是希望在工作流中批量调用 AI，直接使用官方 API 都是最灵活、稳定的方式。DeepSeek 提供了与 OpenAI 兼容的接口，几分钟就能跑通第一个程序。下面我会带你从零开始，完成注册、获取密钥，并用 Python 实现一次真实的对话调用。
### 注册并获取 API Key
打开 DeepSeek 官网，进入开发者平台（通常位于顶部导航栏的“开发者”或“API”入口）。使用手机号或邮箱完成注册，登录后进入「API Keys」页面。
点击「创建 API Key」，系统会生成一个以“sk-”开头的密钥，**请立即复制并保存**，离开页面后将无法再次查看。同时建议在设置中完成实名认证并充值少量余额，以便调用商用模型（如 deepseek-chat），新账户通常也会有免费额度用于测试。
### 环境准备
DeepSeek 的 API 完全兼容 OpenAI SDK，你可以直接使用 `openai` 库。在你的 Python 环境中执行：
```bash pip install openai ```
推荐使用 Python 3.8 及以上版本，并在项目内将 API Key 配置为环境变量，避免硬编码：
```bash export DEEPSEEK_API_KEY="你的sk-xxxx" ```
### 编写调用代码
新建 `chat_demo.py`，写入以下内容：
```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": "你是一个乐于助人的技术博主"}, {"role": "user", "content": "请用 Python 写一个快速排序函数，并添加注释"} ]
# 调用 chat completion response = client.chat.completions.create( model="deepseek-chat", # 或 deepseek-reasoner messages=messages, temperature=0.7, max_tokens=1024 )
# 输出回复 print(response.choices[0].message.content) ```
运行脚本：
```bash python chat_demo.py ```
控制台会打印出 DeepSeek 生成的代码及注释。整个结构和你调用 OpenAI GPT-4 的代码几乎完全一致，迁移成本极低。
### 关键参数说明
- **model**：常用 `deepseek-chat` 处理对话和文本生成，`deepseek-reasoner` 适用于需要深度推理的场景。 - **temperature**：0~1 之间，越低回答越确定，越高越有创造性。代码生成建议 0.3 以下，文案创作可调至 0.8。 - **max_tokens**：限制输出的最大 token 数，防止费用失控。 - **messages**：严格遵循 OpenAI 格式，system 设定角色，user 提出问题，还可以加入 assistant 的历史回复实现多轮对话。
如果需要流式输出，只需在 `create` 中加入参数 `stream=True`，并用 for 循环逐步获取 delta：
```python stream = client.chat.completions.create( model="deepseek-chat", messages=messages, stream=True ) for chunk in stream: delta = chunk.choices[0].delta if delta and delta.content: print(delta.content, end="", flush=True) ```
### 更简单的接入选择
官方 API 需要自行管理 Key 和充值，如果同时使用多个模型，或者在开发阶段想避免繁琐的注册流程，也可以通过 API 中转站统一调用。这里推荐 **TokenPocket API 中转站**（[https://tokenpocket.site](https://tokenpocket.site)），它已经接入 DeepSeek、Qwen、Claude、Gemini 等主流模型，全部按量计费，只需一个 Key 即可调用多个厂商。新用户注册就送免费额度，非常适合快速原型验证和轻量级应用，大幅降低多模型集成的复杂度。