Python接入DeepSeek,原来这么简单

0 阅读5分钟

大家好,我是小民,见字欢喜。

前面几篇文章,我们聊了智能体的概念、思考方式,还亲手搭了一个邮箱助手。

今天咱们来换种玩法——用Python接入DeepSeek API,搭一个自己的AI助手,而且DeepSeek有免费额度,不用花钱也能玩。

01 先说说DeepSeek的免费额度

DeepSeek官方给开发者提供了免费试用额度,根据目前的信息,新用户注册后通常能拿到10块钱左右的tokens额度(约500万tokens),个人开发者能用很久。

⚠️几个小提醒👇

  1. 免费额度一般有30天有效期,过期就没了
  2. 用完需要充值,但价格不贵(输入2元/百万tokens,输出8元/百万tokens)
  3. R1模型比较火爆,有时候响应慢,建议先试V3

我的免费额度一年前就已经过期了😂

查了一下资料,10块钱的额度,按每次对话平均消耗2000 tokens来算,大概能聊2500次,如果每天用10次,能用8个多月,所以果断充10块钱试试手。

02 准备工作:获取API Key

1. 注册账号

DeepSeek官网:platform.deepseek.com

点击注册,用手机号或邮箱完成注册

2. 获取API Key

登录后,进入控制台,找到「API Keys」页面

点击「创建API Key」,给它起个名字,然后复制生成的密钥,格式大概长这样👇

sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

⚠️重要提示: 这个密钥只显示一次,记得保存好!如果丢了,只能重新创建一个了

03 环境配置:安装Python和依赖

检查Python环境,打开终端,输入👇

python --version

如果显示Python3.8或更高版本,就OK了;如果还没安装,就去python.org下载安装包,安装时记得勾选「Add Python to PATH」

04 开始实操

4.1 新建项目

①打开PyCharm,点击New Project

②设置项目位置,比如D:\projects\deepseek-demo

点击Create

4.2 创建文件夹结构

在项目根目录下,手动创建以下文件夹结构

deepseek-demo/
├── core/          # 核心代码
├── examples/      # 示例代码
├── utils/         # 工具函数
├── data/          # 数据文件(可选)
├── .env           # 环境变量(API Key放这里)
├── .gitignore     # 忽略敏感文件
└── requirements.txt  # 依赖列表

这里没什么说的,直接按目录结构手动创建就可以了

4.3 安装依赖

在PyCharm里安装依赖有两种方式👇

① 用终端

在终端里输入如下命令

pip install requests python-dotenv

我已经安装过了

② 用PyCharm界面

点击+号,搜索 requests,点击Install Package

4.4 创建配置文件

在项目根目录,右键 → New → File

① 创建.env文件

注意env前面有个点

DEEPSEEK_API_KEY=sk-你的密钥
DEEPSEEK_MODEL=deepseek-chat

② 创建.gitignore文件

venv/
.env
__pycache__/
*.pyc
.DS_Store
.idea/

③ 创建requirements.txt

requests>=2.31.0
python-dotenv>=1.0.0

这样以后别人拿到你的项目

在终端执行如下命令就能一键安装所有依赖了

pip install -r requirements.txt

4.5 核心代码

这部分代码有点长,我把核心思路讲一下,完整代码就不贴出来了,免得文章太长。

我在utils/config.py里写了一个读取配置的函数,从.env文件里拿到API Key和模型名称。

然后在 core/deepseek_client.py 里封装了一个DeepSeekClient类,主要功能有:

  • chat():发送消息,返回AI回复
  • 支持多轮对话:自动记住上下文
  • 支持流式输出:一个字一个字蹦出来
  • 支持系统提示词:设置AI的角色定位

这样封装之后,调用AI就变成了一行代码👇

client = DeepSeekClient()
reply = client.chat("你好")
print(reply)

💡点击「我的主页」gzh对话框回复「代码」,我把完整源码发你~

05 Demo效果演示

代码写完之后,我在examples/01_hello_world.py里写了一个最简单的调用👇

from core.deepseek_client import DeepSeekClient

client = DeepSeekClient()
reply = client.chat("你好,请介绍一下你自己")
print("DeepSeek说:", reply)

右键运行,效果还不错

还能做什么?我列了6个实用场景

有了这个基础,你就可以在自己的程序里集成AI能力了,我顺手写了6个示例,覆盖了日常最常用的场景👇

示例功能
01_hello_world.py最简单的调用
02_multi_turn.py多轮对话(记住上下文)
03_stream.py流式输出(一个字一个字蹦)
04_summary.py文章总结助手
05_daily_report.py日报生成器
06_customer_service.py客服问答助手

下面看看运行效果👇

多轮对话

流式输出

文章总结助手

日报生成器

客服问答助手

几个踩过的坑

1. API Key找不到

第一次运行时忘了配置.env文件,结果报错说找不到API Key。后来把.env放在项目根目录,在config.py里用load_dotenv() 加载就好了。

2. R1模型没响应

一开始用的deepseek-reasoner(R1模型),等了半天没反应。后来换成deepseek-chat(V3模型),一下子就通了;新手建议先用V3,稳定了再试R1。

3. 流式输出乱码

流式模式下,如果控制台编码不对,可能会显示乱码;在PyCharm里把文件编码设为UTF-8就解决了。

最后来个小结

今天我们用Python接入了DeepSeek API,从零开始搭了一个自己的AI助手,其实核心就三步👇

  1. 注册账号,拿到API Key
  2. 安装依赖,配置环境
  3. 写几行代码,调用API

有了这个基础,大家就可以在自己的程序里集成AI能力了,如:自动回复、内容生成、代码助手、客服机器人……想怎么玩就怎么玩😄

点击「我的主页」,gzh对话框回复「代码」,我把完整源码发你~