API 入门：从 Key 到第一次请求
面向开发者的最小闭环：创建 Key、发起请求、处理错误与控成本。
API 开发更新：2026-03-06API / Key / 请求
开始之前
把 API Key 当作密码管理：只在服务端使用，避免出现在浏览器与公开仓库。
你应当为不同环境（开发、测试、生产）使用不同的 Key，并设置最小权限。
一次请求的关键要素
把“输入、输出、约束、错误处理”统一设计，接口会更稳定。
- 输入：系统提示、用户提示与上下文裁剪策略。
- 输出：结构化格式（例如 JSON）与字段校验。
- 成本：限制最大输出、缓存重复输入、记录 Token 用量。
- 可靠性：重试、退避、幂等、超时与降级策略。
常见错误与排查
建议把错误分成“可重试”和“不可重试”，并为每类制定策略。
- 鉴权失败：Key 无效、权限不足或被禁用。
- 速率限制：请求过快，需要排队或退避。
- 请求过大：上下文过长，需要摘要与裁剪。
- 输出不稳定：需要更强约束与格式校验。