如何使用 Python 调用 DeepSeek-R1 API-step by step 指南

admin
AIGC
2025-06-11
395热度
0评论

本教程将指导您使用 Python 调用 DeepSeek 的 R1 大型模型 API。即使您没有任何编程经验，也可以轻松跟进。文章末尾还包含常见问题解答部分，建议您保存以备参考！

步骤1. 准备

获取您的 API 密钥

首先，登录DeepSeek 平台并获取您的 API 密钥。

在“API 密钥”页面，点击“创建 API 密钥”并复制生成的密钥（例如 sk-123456789abc）。请务必保存该密钥，因为如果忘记或丢失，您需要重新生成一个 API 密钥。

注意：您需要先充值您的账户，然后才能使用您的 API Key。

步骤2.Python设置

1. 设置环境：安装 Python（如果已经安装则跳过）

如果您的计算机上尚未安装 Python，则需要安装它（macOS 预装了 Python 3）。您可以从python.org下载。
下载最新版本（推荐：3.8+）。
安装过程中请务必检查“将 Python 添加到 PATH”。

如果您不需要 Python 环境并且想要使用可视化界面调用 API，请参考本指南：如何使用 Deepseek API（R1 和 V3）：带有屏幕截图的分步指南。

2.安装Requests库（如果已经安装请跳过）

在 VSCode 或其他 IDE 中创建一个新的项目文件夹，然后打开终端（顶部菜单：终端 → 新建终端）并运行以下命令：

pip install requests

或者：

pip3 install requests

如果命令成功运行，您应该会看到如下内容：

或者这样：

Successfully installed requests-x.x.x

如果安装失败，并且您的计算机上已经安装了 Python，则可能是因为安装了多个 Python 版本。该requests库可能仅安装在一个版本的环境中。

您可以在屏幕右下角切换 Python 版本。

你也可以在 VSCode 中安装一个“Python”扩展，并检查当前版本。然后，打开相应版本的控制台面板运行命令。

如果您无法解决这些错误，请跳至本文的最后一部分，其中提供了更简单的调用 DeepSeek-R1 API 的方法。或者，您也可以使用此处的可视化界面方法：如何使用 Deepseek API（R1 和 V3）：step by step 教程。

3. 基本调用代码

一旦上述命令成功执行，.py在您的项目中创建一个文件（例如，deepseek.py）并粘贴以下代码（记得替换sk-your-key为您的实际 API 密钥）。

# deepseek.py

import requests

# Enter your API Key
API_KEY = "sk-your-key"  

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

data = {
    "model": "deepseek-reasoner",  # Use 'deepseek-reasoner' for R1 model or 'deepseek-chat' for V3 model
    "messages": [
        {"role": "system", "content": "You are a professional assistant"},
        {"role": "user", "content": "Who are you?"}
    ],
    "stream": False  # Disable streaming
}

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

if response.status_code == 200:
    result = response.json()
    print(result['choices'][0]['message']['content'])
else:
    print("Request failed, error code:", response.status_code)

您可以通过指定来调用 DeepSeek-V3 API model='deepseek-chat'。

要调用 DeepSeek-R1，请使用model='deepseek-reasoner'。

4.运行代码

您可以通过多种方式运行代码：

点击右上角的“▶”按钮运行代码。
在终端中运行命令python3 deepseek.py或。python deepseek.py
右键单击编辑器并选择“在终端中运行 Python 文件”。

5. 成功输出

当您看到这样的输出时，表示调用成功：

Hi! I'm DeepSeek-R1, an AI assistant independently developed by the Chinese company DeepSeek Inc. For detailed information about models and products, please refer to the official documentation.

步骤3.代码解释

1. 关键参数

范围	描述
`model`	`deepseek-reasoner`适用于 R1 型号
`messages`	对话历史（支持多轮对话）
`stream`	设置`True`为流式输出（适合长文本）

2. 多轮对话示例

messages = [
    {"role": "system", "content": "You are a poet"},
    {"role": "user", "content": "Write a poem about spring"},
    {"role": "assistant", "content": "The spring breeze caresses, the willow branches grow..."},
    {"role": "user", "content": "Please continue the second stanza"}
]

步骤4.流模式

修改以下参数以启用流式传输：

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

# Enter your API Key
API_KEY = "sk-your-API-Key"  

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

data = {
    "model": "deepseek-chat",  # Use 'deepseek-reasoner' for R1 model or 'deepseek-chat' for V3 model
    "messages": [
        {"role": "system", "content": "You are a professional assistant"},
        {"role": "user", "content": "Who are you?"}
    ],
    "stream": False  # Disable streaming
}

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)