版本管理

API 在 /v1 前缀下进行版本管理——以下是当前状态。

每个端点都位于 /v1 之下

本参考文档中的每个路径都带有 /v1 前缀（是 /v1/chat，不是 /chat）。唯一的例外是 /health，它被刻意保留为不带前缀——它是一个基础设施的存活检查（liveness check），不属于已版本化的公开契约的一部分，监控工具直接指向这个无前缀的路径。

现在 API 本身已经发布了一份机器可读的 OpenAPI spec——原始 JSON 位于 /docs-json，交互式 Swagger UI 位于 /docs——它直接从真实的路由处理器和请求/响应类型生成，因此不会像手写文字那样悄悄产生偏离。目前本页面仍然是手写的；将其迁移为直接渲染生成的 spec，而不是手动描述它，是自然的下一步，但目前尚未实现。