快速起步：30 分钟跑通你的第一个 Jev 请求
💡 目标：30 分钟内拿到 TypeSafe API Key，并在本地跑通你的第一个 Jev 请求——一条工单文本，一次拿到「分给哪个组、客户多沮丧、是否紧急」三个结构化答案。这是整部 Jev 教程的第一站。
🎯 阶段目标
- 拿到一把 TypeSafe API Key，存进环境变量
TYPESAFE_API_KEY - 本地跑通第一个 Jev 请求：一条工单文本，一次拿到分类、打分、是非三个答案
- 报错时能对照状态码定位问题：401 查 Key、429 是限流、400 查请求格式
⏳ 预计耗时
- 只想跑通第一个请求：学前 3 课（1.1–1.3），各课合计约 23 分钟，30 分钟绰绰有余
- 学完整个阶段（含备用安装方式与排错）：5 课合计约 37 分钟，预留浮动后约 26–48 分钟
🚀 开始之前
- 一台能上网、能开终端的电脑（官方快速开始的命令按 macOS / Linux / Windows WSL 的 Bash 写）
- Python 3.10 或更高（主路线用 Python SDK；Node.js 22+ 的路线在 1.3b 课讲）
- 能访问
console.typesafe.ai（拿 Key）和api.typesafe.ai（发请求）的网络 - 一杯水 ☕——第一次跑通真的用不了 30 分钟
📚 本阶段课程
| 课程 | 内容 | 时长 |
|---|---|---|
| 1.1 Jev 是什么 | System One 决策模型、和 LLM 的区别、Choice / Score / Noul 三种题型；全程用官方 Playground，不写代码 | 8 分钟 |
| 1.2 注册与 API Key | 在 TypeSafe 控制台拿 Key、用环境变量 TYPESAFE_API_KEY 存放、速率限制去哪查 | 5 分钟 |
| 1.3 安装与第一个请求 | venv + pip 安装 typesafe-sdk，跑通官方工单三问示例 | 10 分钟 |
| ↳ 1.3b 安装备用方式 | uv、npm（JavaScript / TypeScript SDK）、curl 直连 API | 8 分钟 |
| 1.4 起步排错 | 401 / 429 / 400 等状态码对照、SDK 自动重试、常见坑 | 6 分钟 |
🎒 你将收获
- 一把 API Key 和一个能跑的 typesafe-sdk 环境，后面所有阶段直接复用
- 「state + questions → 类型化答案」的第一次完整体验
- Choice / Score / Noul 三种题型的体感和选型直觉
- 一张状态码对照表，卡住时先自查再求助
准备好了吗？开始第一课：Jev 是什么 →