DeepSeek API 接入教程：从注册到 Python 调用实战
如果你正在寻找一个高性价比的大模型 API，DeepSeek 一定进入过你的视野。它在数学、代码生成和中文理解上表现出色，而且价格相当亲民。今天这篇文章就带你走完整个接入流程，从获取 API Key 到用 Python 跑通第一个对话请求，同时还会分享一个让我少走很多弯路的中转站方案。
## 注册与获取 API Key
访问 [platform.deepseek.com](https://platform.deepseek.com) 进入官方控制台。支持邮箱或 Google 账号直接登录，无需企业认证，个人开发者也能顺利注册。成功登录后，在左侧导航栏点击「API Keys」，再点「创建 API Key」，取一个便于自己辨识的名称（比如 `my-app`），系统会生成一串 `sk-` 开头的密钥。**请务必立刻复制并妥善保存**，因为离开页面后将无法再次查看。
有一点需要注意：DeepSeek 的免费额度在注册后一段时间内有效，到期或用完后必须绑定支付方式才能继续调用，这对仅想长期稳定使用的个人用户来说是一个需要考虑的环节。
## Python 环境准备
确保本机已安装 Python 3.8+，然后安装官方推荐但更通用的 `openai` 库，因为 DeepSeek API 完全兼容 OpenAI 接口规范：
```bash pip install openai ```
建议顺手创建一个虚拟环境，保持良好的依赖隔离。
## 第一个对话示例
以下脚本展示了一次完整的聊天补全请求。将代码中的 `your-api-key` 替换为刚刚拿到的密钥，其他参数暂时保持默认即可。
```python import openai
client = openai.OpenAI( api_key="your-api-key", 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) ```
运行后，你会得到一段清晰的带注释 Python 快排代码。整个过程中，`messages` 数组的结构和 `temperature`、`max_tokens` 参数都与 OpenAI 官方接口一致，迁移成本几乎为零。
## 流式输出与多轮对话
复杂任务往往需要流式输出来提升体验。只需在调用时设置 `stream=True`，然后遍历事件流即可：
```python stream = client.chat.completions.create( model="deepseek-chat", messages=[{"role": "user", "content": "讲解 transformer 结构"}], stream=True )
for chunk in stream: delta = chunk.choices[0].delta if delta.content: print(delta.content, end="", flush=True) ```
多轮对话的本质是每次请求时把历史消息一并发送。你可以维护一个 `messages` 列表，将每一轮 `user` 和 `assistant` 的消息追加进去，下次请求时直接复用，模型就会记住上下文。
## 错误处理与计费模型
生产环境中务必加入异常捕获，常见的错误包括网络波动、速率限制（429）和令牌耗尽（402）。一个健壮的调用可以这样写：
```python try: response = client.chat.completions.create(...) except openai.RateLimitError: print("请求过于频繁，等待后重试") except openai.AuthenticationError: print("API Key 无效，请检查") except Exception as e: print(f"其他错误：{e}") ```
DeepSeek 采用按输入输出 token 计费的模式，具体单价可在官方定价页查看。官方接口需要绑定国际信用卡或满足条件的支付方式，这对部分用户来说不太友好。
## 更灵活的选择：TokenPocket API 中转站
如果你希望避开复杂的支付流程，或者想在同一套 Key 里自由切换 DeepSeek、Qwen、Claude、Gemini 等模型，可以试试 [TokenPocket API 中转站](https://tokenpocket.site)。它支持按量计费，用 USDT 直接支付，无需海外信用卡。注册后新用户会获得免费额度，足够你跑通整个教程示例，并且通过统一 OpenAI 格式的接口调用，完全不需要改动现有代码结构。把 `base_url` 换成 TokenPocket 提供的地址，`api_key` 填写平台生成的密钥，就能无缝对接多个大模型，省下不少折腾成本。