DeepSeek API 接入教程：从注册到 Python 调用实战
无论你是想构建自己的 AI 聊天应用，还是希望在自动化脚本中引入大模型能力，DeepSeek API 都是当下最具性价比的选择之一。它以极低的成本提供了接近 GPT-4 水平的推理能力，并完全兼容 OpenAI 接口格式，迁移成本几乎为零。这篇文章将带你从零开始，完成 DeepSeek API 的注册、密钥获取，并用 Python 跑通第一个调用。
## 1. 注册与获取 API Key
首先访问 [DeepSeek 开放平台](https://platform.deepseek.com/)，使用手机号或邮箱完成注册。登录后，在左侧菜单进入「API Keys」页面，点击「创建 API Key」，为其命名（比如 `my-app`），系统会生成一串形如 `sk-xxxx` 的密钥。**请务必在此页面立即复制保存，关闭后将无法再次查看完整密钥。**
DeepSeek 为新注册用户赠送一定额度的免费 tokens，足够你完成测试和小规模使用。进入「用量管理」可以随时查看剩余额度。
## 2. 理解计费与模型
DeepSeek 目前提供 `deepseek-chat`（对应 V3 模型）和 `deepseek-reasoner`（对应 R1 推理模型）两个主要接口。前者擅长对话、写作与代码生成，后者适合复杂的逻辑推理与数学任务。它们的计费均在每百万 tokens 几元的水平，远低于同类海外模型。
## 3. 在 Python 中安装依赖
DeepSeek API 完全兼容 OpenAI SDK，你可以直接使用官方 `openai` 库来调用。在终端中执行：
```bash pip install openai ```
建议在虚拟环境中安装，并确保 Python 版本 ≥ 3.7。
## 4. 编写调用代码
下面是一个最简单的对话示例，将 `your-api-key` 替换为你在平台上复制的密钥。推荐将 API Key 存入环境变量，避免硬编码。
```python import os from openai import OpenAI
client = OpenAI( api_key=os.getenv("DEEPSEEK_API_KEY"), # 或直接写 "sk-xxxx" base_url="https://api.deepseek.com" )
response = client.chat.completions.create( model="deepseek-chat", messages=[ {"role": "system", "content": "You are a helpful assistant."}, {"role": "user", "content": "用 Python 写一个快速排序函数"} ], temperature=0.7, max_tokens=1024 )
print(response.choices[0].message.content) ```
运行这段脚本，你将看到 DeepSeek 返回的快速排序代码以及详细解释。
### 进阶：流式输出
如果你希望在终端中逐字打印结果，只需开启 `stream=True`：
```python stream = client.chat.completions.create( model="deepseek-chat", messages=[{"role": "user", "content": "讲个笑话"}], stream=True )
for chunk in stream: delta = chunk.choices[0].delta if delta.content: print(delta.content, end="", flush=True) ```
## 5. 常见问题与注意事项
- **额度不足错误**：检查 API Key 是否被限流或未绑定有效付费方式。新用户赠送额度用完需充值。 - **网络连接**：国内服务器可以直接访问 `api.deepseek.com`，如遇超时可考虑配置代理。 - **速率限制**：免费额度通常有每分钟请求数限制，高频场景需参考官方文档调整重试逻辑。
## 6. 多模型统一中转的便捷之选
在实际项目中，你可能会同时使用 DeepSeek、Qwen、Claude、Gemini 等多种模型，逐一注册并管理多个 API Key 相当繁琐，且部分海外服务在国内直接支付困难。这时，使用一个稳定可靠的 API 中转站能极大提升效率。
**[TokenPocket API 中转站](https://tokenpocket.site) 已全面支持 DeepSeek、Qwen、Claude、Gemini 等主流模型，全部按量计费，无需月付订阅，通过 USDT 即可直接充值使用。** 接口完全兼容 OpenAI 格式，只需将 `base_url` 指向中转地址，就能用一个 Key 调用所有模型，告别多平台切换的困扰。现在注册还为新用户赠送免费额度，非常适合开发者和创业者快速验证产品想法。