模型、API Key 和订阅是什么？

02-03 模型、API Key 和订阅是什么？

课程定位

这一课解释工具背后的能力来源。

很多学员安装完工具后，会看到模型、订阅、API Key、额度、Provider 等词。一下子看到这些词，会误以为自己进入了很深的技术区。

这节课只讲一个足够好用的心智模型：模型是发动机，订阅和 API Key 是开门方式。学员不用掌握底层技术，也能知道自己正在配置什么。

本课目标

• 让学员知道模型提供 AI 能力。
• 让学员理解订阅和 API Key 都是调用模型的方式。
• 让学员知道 API Key 要妥善保存。
• 让学员会判断当前配置是否能回复、能读项目。
• 让学员完成一次配置后的最小测试。

录制建议

• 建议时长：22 到 30 分钟。
• 用钥匙和门的比喻讲，不深入技术细节。
• 只演示课程需要的配置入口。
• 强调 Key 的安全保存。
• 不讲模型排行，不引导学员陷入参数比较。

讲稿正文

可以这样开场：

“你可以把 AI 工具想象成一辆车。工具界面是驾驶舱，模型是发动机。订阅或 API Key，是让你能启动这台发动机的方式。”

先讲模型。

“模型决定 AI 的能力。不同模型擅长的事情不同，有的适合写代码，有的适合长文理解，有的速度更快。刚开始学，跟着课程选择推荐模型就行。”

再讲订阅。

“订阅就是你登录账号后，平台帮你处理调用模型这件事。很多图形工具会用这种方式，学员感知比较少。你只需要确认账号已登录、额度正常、模型可选。”

然后讲 API Key。

“API Key 像一把访问钥匙。工具拿着这把钥匙，去调用对应模型。钥匙要自己保管，别发到群里，别写进公开项目，别截图发到公开笔记里。”

这里要给学员安全边界：

• 课程笔记里可以写“我使用 API Key 方式配置”。
• 课程笔记里不要写完整 Key。
• 发给 AI 排查时，不要发完整 Key。
• 如果不小心公开了 Key，要去平台重置。

接着讲 Provider。

“Provider 可以理解成模型服务来源。你暂时不用记住所有名字，只要知道：工具需要知道从哪里调用模型。”

接着讲最小测试：

“配置是否成功，别靠猜。发一句测试问题，看 AI 是否正常回复，再让它读取当前项目文件夹。能回复、能读现场，配置就通过第一关。”

测试表达：

请用一句话介绍你现在能帮我做什么。

项目读取表达：

请说明你现在看到的项目文件。
如果你看不到，请告诉我需要检查工具设置还是文件夹授权。

最后收束：

“这一节不追求把所有模型名都讲完。你只要知道：模型提供能力，订阅或 Key 提供访问，配置后做测试。”

屏幕演示流程

1. 打开主线工具的模型设置区域。
2. 展示模型选择位置。
3. 展示订阅登录状态或 API Key 配置入口。
4. 说明 Key 的保存方式。
5. 发送测试问题：“请用一句话介绍你现在能帮我做什么。”
6. 打开项目文件夹，让 AI 复述文件。
7. 保存配置检查记录。

课堂练习

让学员完成配置检查：

• 我当前用的是账号订阅还是 API Key。
• 我选择的模型名称是什么。
• AI 是否能正常回复。
• AI 是否能读取当前项目。
• 我是否没有在笔记里保存完整 Key。

如果配置失败，让学员把现场交给 AI：

我正在配置 AI 工作台。
我的配置方式是账号订阅 / API Key。
当前问题是：
我看到的提示是：
请告诉我下一步先检查哪 3 项。

常见卡点

• 模型列表太多：先选课程推荐模型。
• Key 粘贴后无效：检查有没有复制多余空格。
• 配置成功但 AI 不回复：检查网络、额度和模型选择。
• 学员把 Key 发给别人：强调它相当于访问钥匙。
• 学员纠结哪个模型最好：先用课程推荐模型跑通工作流。

课后作业

保存一份配置检查记录，不需要保存完整 Key，只记录配置方式和测试结果。

补充要求：

• 写明模型名称。
• 写明配置方式。
• 截图保存 AI 成功回复。
• 让 AI 复述当前项目文件。

课件页建议

• 第 1 页：标题“模型是发动机”
• 第 2 页：工具界面是驾驶舱
• 第 3 页：订阅是一种开门方式
• 第 4 页：API Key 是访问钥匙
• 第 5 页：Provider 是服务来源
• 第 6 页：Key 的安全边界
• 第 7 页：配置后做最小测试