实战案例 01

Hello LLM：第一次调用模型 API

这节课是整个实战案例体系的起点。它不追求复杂框架，而是先完成一次最小可用的大模型 API 调用，并把后续 RAG、Agent、模型切换都会复用的工程习惯建立起来。

学完你会得到

1

知道一次模型 API 请求由哪些部分组成

2

能安全保存 API Key，不把密钥提交到仓库

3

能完成一次非流式文本生成调用

4

理解流式输出的基本工作方式

5

能识别并处理常见 API 错误

6

能估算一次调用的大致 token 成本

理解 API Key、环境变量、额度和 .gitignore 的基本安全习惯。

拆解 model、messages、temperature、max_tokens 等核心字段。

用最少代码发起一次模型请求，并打印模型回答。

理解为什么聊天产品会一个字一个字出现，以及如何接收流式响应。

处理 401、429、400、413、500 等典型错误状态。

记录 usage，估算 token 成本，并抽出可复用的 callModel 函数。

适合刚从网页聊天转向 API 开发的学习者，也适合想给后续 RAG、Agent 项目打工程基础的开发者。

会使用命令行了解环境变量知道 API Key 是调用凭证能读懂基础 TypeScript/JavaScript