1履约任务12 分钟

认识 LLM 工作原理与 API 本质

搞懂 LLM 是按概率续写 token,掌握 Chat API 请求响应结构与为什么必须做应用层网关。

LLMChat API入门Python
进度保存在本机浏览器;验收通过后再点更稳妥
本课任务 · AI 履约学法

经自家后端调通一次非流式 Chat API,返回统一 Result 格式。

推荐:复制 Prompt → 在 AI大模型/AI编程工具 改项目 → 跑验收 → 再展开下方概念卡。不必先对着仓库读代码。

Prompt
你在 codehub-llm-core 项目中工作(若仓库为空,先按 Phase 0 骨架初始化)。

本课目标:
1. 实现 POST /api/chat(非流式),内部经统一 LLM 客户端调用 OpenAI 兼容 API
2. 响应必须是统一格式:{"request_id","code","message","data"}
3. API Key 只放 .env,禁止出现在前端

约束:
- FastAPI + Pydantic v2
- Router 不直接 httpx 调厂商,必须走 services/llm/
- 不实现 SSE、工具调用、RAG

完成后运行:npm run verify:llm-01(或文档中的 curl 验收)
验收标准npm run verify:llm-01
  • POST /api/chat 返回 code=0 与 assistant 文本
  • 响应含 request_id
  • .env.example 有 OPENAI_API_KEY / OPENAI_BASE_URL

卡关对照:Gitee tag phase-1-llm-api(验收通过后再看,或路径 C 直接 checkout)