Python调用DeepSeek – R1 API全攻略

文章标题：

Python调用DeepSeek - R1 API全方位指南

文章内容：

原文链接：怎样用 Python 调用 DeepSeek-R1
API？超详尽的图文教程

本教程会一步步带领你通过 Python 去调用 DeepSeek 的 R1 大模型 API，就算没有编程基础也能轻松操作。文末还有常见问题的解答，建议收藏起来备用！

一、前期准备

获取 API Key

首先登录 DeepSeek 控制台，去获取 API Key。首次注册登录的用户，DeepSeek 会赠送 10 块钱的 tokens 额度（先看看有没有，也有可能不再赠送了，要是没有额度的话就得先充值）。

在「API Keys」页面点击「创建 API Key」，把生成的密钥复制下来（比如：sk-123456789abc）。一定要保存好，如果忘记或者弄丢了就需要重新创建一个 API Key。

二、Python 调用步骤

1. 环境准备：安装 Python（已安装可跳过）

• 要是电脑没有 Python 环境，得先去安装 Python 环境（macOS 自带 Python3 环境）。可以访问 python.org 进行下载安装。
• 下载最新版本（推荐 3.8+）
• 安装的时候一定要勾选 Add Python to PATH

不需要 Python 环境，直接通过可视化界面来调用 API 的方法：Deepseek API
调用教程，图文讲解

2. 安装 requests 库（已安装可跳过）

在 VSCode 或者其它 IDEA 工具中，新建一个项目文件夹，然后打开终端（顶部菜单：Terminal → New Terminal）执行以下命令：
pip install requests 或 pip3 install requests

要是命令执行成功，会出现类似这样的提示：

或者是这样的：
Successfully installed requests-x.x.x

要是安装失败，而且你的电脑有 Python 环境，那可能是因为你的系统中有多个 Python 版本，导致你在不同的环境中用了不同的 Python 版本，而 requests 库可能只安装在其中一个版本的环境里。

你可以在页面右下角切换版本。

还能在 VSCode 中安装一个名为 “Python” 的插件，然后通过下面的方式来查看你当前的版本，并打开对应版本的控制台面板来运行上面的命令，比如：

要是实在解决不了这些报错问题，可以跳到文章的最后一个小节，那里有更简单的调用 DeepSeek-R1 API 的方法。或者直接访问这篇文章，通过可视化的面板来调用 API：Deepseek API
调用教程，图文讲解

3. 基础调用代码

上面的命令执行成功后，在项目中新建一个以 .py 结尾的文件，比如 deepseek.py 文件，把以下代码复制粘贴进去（注意替换 sk-你的密钥）。

# deepseek.py 

import requests

# 填写你的 API Key
API_KEY = "sk-你的密钥"  

url = "https://api.deepseek.com/chat/completions"
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_KEY}"
}

data = {
    "model": "deepseek-reasoner",  # 指定使用 R1 模型（deepseek-reasoner）或者 V3 模型（deepseek-chat）
    "messages": [
        {"role": "system", "content": "你是一个专业的助手"},
        {"role": "user", "content": "你是谁？"}
    ],
    "stream": False  # 关闭流式传输
}

response = requests.post(url, headers=headers, json=data)

if response.status_code == 200:
    result = response.json()
    print(result['choices'][0]['message']['content'])
else:
    print("请求失败，错误码：", response.status_code)

通过指定 model='deepseek-chat' 就能调用 DeepSeek-V3。

通过指定 model='deepseek-reasoner'，就能调用 DeepSeek-R1。

4. 运行代码

可以通过以下几种方式来运行代码：
* 可以点击右上角「▶」按钮来运行代码
* 可以在控制台通过python3 deepseek.py 或 python deepseek.py来运行代码
* 可以 “右键编辑器 → Run Python File in Terminal” 来运行代码

5. 成功效果

当看到类似以下输出就表示调用成功：

您好！我是由中国的深度求索（DeepSeek）公司开发的智能助手DeepSeek-R1。如您有任何任何问题，我会尽我所能为您提供帮助。

或者其它问题的答案。

量子计算是一种利用量子力学特性进行信息处理的新型计算模式，其核心原理与传统经典计算有本质区别。以下是量子计算的基本原理分点解释：

---

### 1. **量子比特（Qubit）**
   - **经典比特 vs. 量子比特**  
     经典计算机使用比特（0或1）作为信息基本单位，而量子计算机使用量子比特（qubit）。量子比特的独特之处在于它可以同时处于0和1的**叠加态**。
   - **叠加态（Superposition）**  
     量子比特的状态可表示为：  
     \[
     |\psi\rangle = \alpha|0\rangle + \beta|1\rangle
     \]  
     其中，\(\alpha\)和\(\beta\)是复数（概率幅），满足\(|\alpha|^2 + |\beta|^2 = 1\)。测量时，量子比特会坍缩到0或1，概率分别为\(|\alpha|^2\)和\(|\beta|^2\)。  
     **类比**：想象一枚旋转的硬币，在停下前既是“正面”又是“反面”。

---

### 2. **量子纠缠（Entanglement）**
   - **定义**  
     多个量子比特可形成纠缠态，此时一个量子比特的状态会瞬间影响另一个，即使它们相隔遥远（爱因斯坦称为“鬼魅般的超距作用”）。
   - **示例**  
     贝尔态（Bell state）是最简单的纠缠态之一：  
     \[
     |\Phi^+\rangle = \frac{|00\rangle + |11\rangle}{\sqrt{2}}
     \]  
     若测量其中一个量子比特为0，另一个必然也是0，反之亦然。
   - **作用**  
     纠缠是实现量子并行性和量子通信（如量子隐形传态）的关键。

三、代码解析

1. 关键参数说明

2. 多轮对话示例

messages = [
    {"role": "system", "content": "你是一位诗人"},
    {"role": "user", "content": "写一首关于春天的诗"},
    {"role": "assistant", "content": "春风拂面柳丝长..."},
    {"role": "user", "content": "请继续补充第二段"}
]

四、流式传输模式

修改以下参数就能开启：

data["stream"] = True

response = requests.post(url, headers=headers, json=data, stream=True)

for line in response.iter_lines():
    if line:
        decoded_line = line.decode('utf-8')
        print(decoded_line)

完整代码：

# deepseek.py 

import requests

# 填写你的 API Key
API_KEY = "sk-你的 API Key"  

url = "https://api.deepseek.com/chat/completions"
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_KEY}"
}

data = {
    "model": "deepseek-chat",  # 指定使用 R1 模型（deepseek-reasoner）或者 V3 模型（deepseek-chat）
    "messages": [
        {"role": "system", "content": "你是一个专业的助手"},
        {"role": "user", "content": "你是谁？"}
    ],
    "stream": False  # 关闭流式传输
}

data["stream"] = True

response = requests.post(url, headers=headers, json=data, stream=True)

for line in response.iter_lines():
    if line:
        decoded_line = line.decode('utf-8')
        print(decoded_line)

下面用的是 V3 模型（deepseek-chat）输出的结果，为啥不用 R1？太火爆了，经常没响应：

五、常见问题

Q1：如何区分 V3 和 R1 模型？

• V3：model: "deepseek-chat"
• R1：model: "deepseek-reasoner"

Q2：出现 401 错误？

• 检查 API Key 是否填写正确
• 确认密钥未过期

Q3：出现「No module named 'requests'」？

检查是否：
1. 在正确的终端执行了 pip install requests
2. VSCode 使用的是正确的 Python 解释器（见上文）

Q4：出现 requests.exceptions.JSONDecodeError: Expecting value: line 1 column 1？

嗯……，跟“服务器繁忙”一个道理，可能用的人太多，响应失败了。

错误提示 Expecting value: line 1 column 1 (char 0) 表示 json() 方法期望收到的是一个有效的 JSON 数据，但实际收到的内容为空。这可能是因为 API 没有返回数据，或者返回的是一个空的响应体。

Q5：为什么启用流式输出后一直出现 keep-alive？

嗯……，跟“服务器繁忙”一个道理，可能用的人太多，所以一直处于长连接状态。

六、更简单的调用 DeepSeek-R1 API 的方法（推荐）

你可以在 Apifox 中调用 DeepSeek-R1 API 或者 DeepSeek-V3 API，你可以通过 Apifox 来进行流式输出结果：

或者整体输出结果：

详情请查看这篇文章：【Deepseek API 调用教程，图文讲解】

通过本教程，你已经掌握了 DeepSeek API 的核心调用方法。建议先从简单对话开始测试，逐步尝试流式传输、多轮对话等高级功能。如果在实践中遇到问题，欢迎在评论区留言讨论！