大模型 API 调用
Lv2 主线课。网页上聊天你已经会了,这门课让你的代码去问模型——问完的结果,程序可以接着处理,每周自动跑。
这门课不讲模型原理,也不碰框架。全程只做一件事:一章一章,把一个「周报生成器」做出来。
周五下午,你翻着这周的聊天记录、待办和 Git 提交,拼一份周报,半小时过去了。学完 8 章,这件事变成一条命令:
bash
python weekly.py notes.md读进你这周的零散记录,两秒左右输出一份分好类、带下周计划的周报,存成文件,顺便告诉你这次花了多少钱(不到一分)。
🧩 这门课解决什么问题
会用网页版 AI,到会用代码调模型,中间卡着几道坎:
| 卡在哪 | 这门课怎么解 |
|---|---|
| 门槛感 「API 是程序员的事,我写不来」 | 第 1 章 10 分钟内拿到第一次回答,代码不超过 10 行 |
| 黑盒感 「为什么它不记得我上一句话?」 | 第 2 章拆开消息结构,记忆是你自己拼给它的 |
| 不放心 「会不会一不小心扣很多钱?」 | 第 5 章算清楚:一份周报约 0.0015 元,一年不到一毛 |
| 不稳定 「跑着跑着报错了,不知道为什么」 | 第 6 章把超时、限流、余额不足都处理掉 |
🗺️ 学习路线图
| 阶段 | 周报生成器做到哪一步 |
|---|---|
| 📗 跑起来 第 1 ~ 2 章 | 丢一段记录进去,拿回一份周报草稿;能说「再精简一点」 |
| 📘 调得准 第 3 ~ 4 章 | 每次格式稳定;周报一个字一个字地流出来 |
| 📙 用得起 第 5 ~ 6 章 | 每次打印花费;出错自动重试,Key 不进代码 |
| 📕 带得走 第 7 ~ 8 章 | 换一家模型只改两行;做成命令行工具,每周五一条命令 |
📚 章节导航
| # | 章节 | 难度 | 预计阅读 | 周报生成器新增的能力 |
|---|---|---|---|---|
| 1 | 第一次调用:从网页聊天到 API | ⭐ | 12 min | 一行 curl、几行 Python,拿到第一份周报草稿 |
| 2 | 消息结构:模型其实没有记忆 | ⭐ | 12 min | 用 system 定角色;多轮修改「再精简一点」 |
| 3 | 参数怎么调:让输出稳定下来 | ⭐⭐ | 10 min | 同一份记录跑 5 次,格式不再每次都变 |
| 4 | 流式输出:打字机效果是怎么来的 | ⭐⭐ | 12 min | 周报边生成边显示,不用干等 |
| 5 | Token 与计费:一份周报花多少钱 | ⭐⭐ | 10 min | 每次运行打印 token 用量与花费 |
| 6 | 出错了怎么办 | ⭐⭐⭐ | 12 min | 超时、限流、余额不足自动处理;Key 放环境变量 |
| 7 | 换一家模型只改两行 | ⭐⭐ | 10 min | 同一份代码切换 DeepSeek、通义千问、Kimi、OpenAI |
| 8 | 综合实战:周报生成器完工 | ⭐⭐⭐ | 15 min | python weekly.py notes.md 一条命令出周报 |
🎯 适合人群
| 你是 | 从哪开始 | 建议 |
|---|---|---|
| 学完 Lv1 Python 的新手 | 第 1 章 | 按顺序读,每章末尾的「试一试」一定动手 |
| 会写代码,没调过模型 | 第 1 章快速过,重点看第 2、5、6 章 | 消息结构、计费、错误处理是最容易踩坑的地方 |
| 调过 API,想补全知识 | 第 4、6、7 章 | 流式、重试、多家模型切换 |
前置知识:会装 Python 包、会在终端里运行 .py 文件(Lv1「Python 零基础」前几章)。不会也没关系,第 1 章的 curl 版本不需要写代码。
准备:一个 DeepSeek 账号,充几块钱。为什么默认用 DeepSeek:国内直接能访问、注册简单、按量计费很便宜;接口和 OpenAI 一样,第 7 章换别家只改两行。
📂 目录结构
llm-api/
├── README.md # 本页
├── chapters/ # 8 个章节,每章独立文件
│ ├── 01-first-call.md
│ ├── ...
│ └── 08-weekly-cli.md
└── images/ # 配图:示意图(SVG)与截图(PNG),按章节编号 c1- c2- …💡 提示:每章末尾都有「下一章预告」,周报生成器的进度会在那里接上。