d3.2实操⏱ 约 10 分钟
第一次 API 调用:一段代码跑通
别怕,代码已经替你写好了——你只负责把钥匙插进去
🔎 最后验证 2026-07📚 来源:🧰 DeepSeek 开放平台、Python✅ 13 人学过
为什么学这个
钥匙(API Key)已经在你手里了。今天把水管真正接通:让一段程序替你去问 DeepSeek 问题,再把答案带回来。
「我不会写代码啊。」——还记得 d2.5 吗?你不用会写,你只需要会用。这一节的代码我已经替你备好了,一共十几行,每一行是干嘛的都用人话讲给你听。跑通那一刻,你会发现 API 没有任何神秘的。
先看懂:一次调用到底发生了什么
💡 打个比方
一次 API 调用,就是往窗口递一张格式固定的点单小票:
model:找哪位厨师——deepseek-v4-flash(轻快便宜)还是deepseek-v4-pro(旗舰);messages:小票正文。里面system是给店员的岗前须知(「你是个说话简洁的助手」),user是你实际点的单(你的问题);- 递进窗口(发送请求)→ 厨房出菜(返回回答)。
网页版聊天的每一句话,底层走的就是这张小票。今天只是你亲手填一次。
还有个好消息:DeepSeek 的 API 用的是 OpenAI 兼容格式——相当于插座用了国标。市面上几乎所有 AI 工具、教程、代码库,只要改两个字段(接口地址和 Key)就能直接对上 DeepSeek,这是下一节「接客户端」的伏笔。
第一步:准备环境(没装过 Python 也不怕)
跑这段代码需要电脑上有 Python 和 openai 库。没装过?把环境问题外包给 DeepSeek 自己——这正是甲方姿势:
🤖 让 DeepSeek 当你的装机师傅
我的电脑是【Windows / Mac】,从来没装过 Python。请一步步教我:①安装 Python;②安装 openai 这个库;③怎么把一段代码保存成 .py 文件并运行它。每一步都按完全没碰过编程的人来讲,我卡住了会把报错发给你。
装好后回来继续。(以后任何一步报错,都把报错原文整段贴回给它——d2.5 的万能修理句式,在这里同样管用。)
第二步:十几行代码,跑通
新建一个文件 first.py,把下面的内容粘进去,把第 4 行换成你自己的 Key,然后运行它:
from openai import OpenAI
client = OpenAI(
api_key="sk-你的Key粘在这里",
base_url="https://api.deepseek.com"
)
response = client.chat.completions.create(
model="deepseek-v4-flash",
messages=[
{"role": "system", "content": "你是一个说话简洁的中文助手。"},
{"role": "user", "content": "用一句话,向一个刚跑通第一次 API 调用的人表示祝贺。"}
]
)
print(response.choices[0].message.content)
屏幕上打出它的回答了吗?恭喜,水管通了。逐行翻译一下你刚做的事:
base_url:把水管接到 DeepSeek 家(不写这行就接到 OpenAI 家去了——「国标插座」的两处改动之一);api_key:插上你的钥匙(另一处改动);model:点了轻快便宜的 flash——日常打杂用它,难题再换 pro;messages:那张点单小票,system 设人设、user 提问题;print(...):把厨房递出来的菜端上桌。
想要网页版那个「深度思考」?加一个参数就是它的 API 开关:
extra_body={"thinking": {"type": "enabled"}}
把这行加进 create(...) 的括号里(和 messages 并列)即可。更多参数以官方文档为准——但第一天,会开关思考就够了。
跑不通?九成是这三种
⚠️ 避坑
- 报错提示鉴权/余额问题:Key 抄错了、或忘了充值(回看 d3.1)。Key 必须是
sk-开头完整一串; - 照着旧教程写了
model="deepseek-chat"或"deepseek-reasoner":这两个旧模型名已于 2026 年 7 月 24 日停用,直接报错。换成deepseek-v4-flash或deepseek-v4-pro——顺便,看到还在教旧模型名的教程可以整篇不信了; - 其他一切报错:不要盯着代码硬看,把报错原文整段贴给 DeepSeek,让它诊断。这不是偷懒,这是标准工作流。
另外,这个写着 Key 的文件等于一张写着银行卡密码的纸:别发给别人、别上传到任何公开地方。以后写正经项目会学到把 Key 放进「环境变量」,今天先记住「不外传」三个字。
❓ 测验
你照着一篇 2025 年的教程写代码,model 填的是 deepseek-chat,一运行就报错。最可能的原因和正确做法是?
✅ 小结
- 一次调用=递一张点单小票:model 选厨师,messages 里 system 设人设、user 提问题
- OpenAI 兼容=国标插座:任何工具改 base_url + Key 两处就能接 DeepSeek
- 深度思考的 API 开关:thinking 参数(extra_body 里加一行)
- 跑不通三板斧:查 Key 与余额 / 换掉旧模型名 / 报错原文整段贴给 AI
下一节 → 代码跑通证明了水管是通的,但日常聊天总不能每次跑脚本——下一节,把 Key 填进现成的桌面客户端,三分钟拥有一个更强的「私人版 DeepSeek」。

都看到这了,打个赏呗!
接下来 · d3.3
接进顺手的客户端:三分钟装一台「饮水机」
继续读下一节 →