← 返回目录
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 并列)即可。更多参数以官方文档为准——但第一天,会开关思考就够了。

跑不通?九成是这三种

⚠️ 避坑
  1. 报错提示鉴权/余额问题:Key 抄错了、或忘了充值(回看 d3.1)。Key 必须是 sk- 开头完整一串;
  2. 照着旧教程写了 model="deepseek-chat""deepseek-reasoner":这两个旧模型名已于 2026 年 7 月 24 日停用,直接报错。换成 deepseek-v4-flashdeepseek-v4-pro——顺便,看到还在教旧模型名的教程可以整篇不信了;
  3. 其他一切报错:不要盯着代码硬看,把报错原文整段贴给 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
接进顺手的客户端:三分钟装一台「饮水机」
继续读下一节 →