接入DeepSeek API，看这一篇就够了，超详细

kestiny

1194人浏览 · 2025-03-20 23:35:34

kestiny · 2025-03-20 23:35:34 发布

文章目录

1. 准备材料清单

前言

DeepSeek API 是一个强大的自然语言处理工具，提供了文本生成、语义分析、对话系统等功能。无论是开发智能客服、聊天机器人，还是进行文本分析与生成，DeepSeek API 都能为你提供强大的支持。本文将带你从零开始，一步步完成 DeepSeek API 的接入，并编写你的第一个 AI 程序。

准备材料清单

在开始之前，请确保你已准备好以下内容：

一台可以联网的电脑：Windows、macOS 或 Linux 均可。
一个 DeepSeek 账号：用于获取 API Key。
Python 环境：推荐使用 Python 3.7 及以上版本。
代码编辑器：如 VS Code、PyCharm 或 Jupyter Notebook。
网络连接：确保可以访问 DeepSeek API 的服务地址。

2. DeepSeek 账号准备

注册 DeepSeek 账号

访问 DeepSeek开放平台官网，当然你也可以试试酷炫的顶级域名https://ai.com(未来可能会失效)
填写手机号（一定是你手头手机或者能很方便的获取到短信内容的手机）
发送验证码，并从手机短信里拿到验证码，填写验证码
点击“登录”按钮，完成DeepSeek登录验证

充值

登录后，打开DeepSeek开放平台的“用量信息”页面
点击“去认证”，DeepSeek需要你实名认证后，才能充值。填写你的姓名和身份证号即可。
完成充值

获取 API Key

在DeepSeek开放平台，点击“API Keys”2. 非常重要将生成的 API Key 保存到安全的地方，后续调用 API 时会用到，再次强调下，生产后的API key，之后在无法查看了。
如果，再步骤2的时候未能及时的保存API key的内容，也不要担心，两步操作：
- 删除找不到的key
- 新建一个API key并记录下内容
小建议：为每一个APP创建一个API key。

更多关于DeepSeek开放平台功能，请自行探索。

3. Python 环境安装

安装 Python

访问 Python 官网下载最新版本的 Python，这里是3.13.2版本；
运行安装程序，确保勾选“Add Python to PATH”选项，并一路next默认安装；
完成安装后，打开终端（或命令提示符），输入以下命令验证安装是否成功：
```
python --version
```
如果显示 Python 版本号（如 Python 3.13.2），说明安装成功。

安装依赖库

DeepSeek API 的调用通常需要 openai sdk 库来发送 HTTP 请求。使用以下命令安装：

pip install openai

验证安装

运行以下命令，查看已安装的库：

pip list

如果显示 openai 1.66.3之类，说明安装成功。

4. AI 界的 “Hello World” 程序

编写第一个程序

以下是一个简单的 Python 程序，用于调用 DeepSeek API 的文本生成功能：

#-*-coding:utf-8-*-

from openai import OpenAI
from pprint import pprint

API_KEY = "your_api_key_here"  # 替换为你的 DeepSeek API Key

def models():
    client = OpenAI(
        api_key=API_KEY,
        base_url="https://api.deepseek.com/"
    )
    models = client.models.list()
    pprint(models.data)

if __name__ == "__main__":
    models()

代码解释

API Key：替换 your_api_key_here 为你的实际 API Key，也就是在第二步中获取的API key，并确保 API 地址正确。
定义函数models: 定义函数，获取模型列表。
1. client：使用openai sdk创建一个客户端对象。
2. 查询支持的模型列表：查询DeepSeek支持的模型列表。
3. 输出模型：美化输出从DeepSeek服务器上获取的所有支持的模型。
调用函数: 再主函数中调用刚刚定义好的models函数，并完成模型列表的获取与返回内容输出。

运行结果

运行程序后，如果一切正常，你会看到类似以下的输出(可能比我的模型多)：

[Model(id='deepseek-chat', created=None, object='model', owned_by='deepseek'),
 Model(id='deepseek-reasoner', created=None, object='model', owned_by='deepseek')]

如果你看到类似的输出，那么恭喜你！接入DeepSeek API大功告成！撒花庆祝

ps: deepseek-chat目前是deepseek-v3，deepseek-reasoner目前deepseek-r1。

错误处理

网络问题：确保你的网络连接正常，可以访问 DeepSeek API 的服务地址。
DeepSeek API调用常见错误如下：

错误码	描述
400 - 格式错误	原因：请求体格式错误解决方法：请根据错误信息提示修改请求体
401 - 认证失败	原因：API key 错误，认证失败解决方法：请检查您的 API key 是否正确，如没有 API key，请先创建 API key
402 - 余额不足	原因：账号余额不足解决方法：请确认账户余额，并前往充值页面进行充值
422 - 参数错误	原因：请求体参数错误解决方法：请根据错误信息提示修改相关参数
429 - 请求速率达到上限	原因：请求速率（TPM 或 RPM）达到上限解决方法：请合理规划您的请求速率。
500 - 服务器故障	原因：服务器内部故障解决方法：请等待后重试。若问题一直存在，请联系我们解决
503 - 服务器繁忙	原因：服务器负载过高解决方法：请稍后重试您的请求