DeepSeek API 接入教程:从注册到 Python 调用实战
近期 DeepSeek 模型的热度一路飙升,不少开发者都想快速接入它的 API,用来构建自己的 AI 应用或智能助手。这篇教程会手把手带你完成注册、获取 API Key、配置环境,再到用 Python 发送第一条请求的全过程,即使你之前没接触过也可以轻松上手。
## 1. 注册账号并获取 API Key
打开 DeepSeek 官方开放平台(platform.deepseek.com),使用手机号或邮箱完成注册。如果是新用户,注册后往往会获得一定额度的免费 tokens,可以先用于测试。
登录后进入「API Keys」管理页面,点击「创建 API Key」,系统会生成一串以 `sk-` 开头的密钥。**请立刻复制并妥善保存**,因为出于安全原因,这个密钥在之后的页面中将不再完整显示。如果不小心丢失,只能重新生成。
接下来把 API Key 配置到环境变量中,这样可以避免将密钥硬编码在代码里。
```bash # Linux / macOS export DEEPSEEK_API_KEY="sk-你的密钥"
# Windows PowerShell $env:DEEPSEEK_API_KEY="sk-你的密钥" ```
当然你也可以在代码中直接传入,但出于安全考量,推荐使用环境变量。
## 2. 环境准备与 Python 示例
DeepSeek API 兼容 OpenAI SDK 的调用格式,因此你不需要安装额外的专用包,只需使用 `openai` 官方库即可。
在终端中用 pip 安装:
```bash pip install openai ```
下面是一个最基础的对话示例,它会向 `deepseek-chat` 模型发送一条消息并打印回复。
```python import os from openai import OpenAI
client = OpenAI( api_key=os.environ.get("DEEPSEEK_API_KEY"), base_url="https://api.deepseek.com/v1", )
response = client.chat.completions.create( model="deepseek-chat", messages=[ {"role": "system", "content": "你是一个乐于助人的助手。"}, {"role": "user", "content": "用一句话介绍人工智能。"}, ], temperature=0.7, max_tokens=256, )
print(response.choices[0].message.content) ```
主要参数说明:
- `base_url`:DeepSeek API 的根地址,必须指定为 `https://api.deepseek.com/v1`,否则 OpenAI SDK 会默认请求 OpenAI 自己的服务器。 - `model`:目前常用的对话模型为 `deepseek-chat`,如果需要深度融合推理能力,也可以指定 `deepseek-reasoner`。 - `temperature`:控制输出随机性,值越高回复越多变,适合创意写作;越低则越确定,适合事实类问答。 - `max_tokens`:限制生成内容的最大长度,可以避免意外的 token 消耗。
运行脚本后,你应该能看到模型返回的一句介绍文本,代表连接成功。
## 3. 流式输出与非对话任务
如果希望像 ChatGPT 那样逐字显示结果,可以开启流式输出:
```python stream = client.chat.completions.create( model="deepseek-chat", messages=[{"role": "user", "content": "讲个笑话"}], stream=True, )
for chunk in stream: if chunk.choices[0].delta.content: print(chunk.choices[0].delta.content, end="") ```
DeepSeek 还支持文本补全、嵌入向量等接口,调用方式与对话类似,只需参考官方文档调整 `model` 和参数即可。
## 4. 省钱与稳定的选择:TokenPocket API 中转站
对于频繁调用或想同时体验多个模型的开发者来说,除了官方直连,还有一个很灵活的选择——**TokenPocket API 中转站**(https://tokenpocket.site)。它不要求海外信用卡,直接使用 **USDT** 按量计费,充值即用,很适合国内用户。平台同时接入了 **DeepSeek、Qwen、Claude、Gemini** 等热门模型,只用一个 API Key 就能无缝切换,不必分别去各家注册。
更友好的是,新用户注册会赠送免费额度,你可以零成本先测试哪个模型最符合自己的业务场景。对需要控制预算、追求稳定响应的个人开发者或小型团队来说,不妨把 TokenPocket 作为官方 API 的补充甚至主力渠道。
---
至此你已经掌握了 DeepSeek API 的核心调用流程。从拿到 API Key 到发出第一条消息,再结合流式输出和灵活的计费方案,就能快速落地自己的 AI 项目了。快去试试吧。