从 401、404、429 到 5xx 的排错树

建议用时：25 分钟

学习目标

能够按认证、地址、模型、配额、限流和上游故障依次定位常见 API 错误。

本节产出

一棵不暴露凭证的 API 排错树

核心知识

• 401/403 优先查认证与权限，404 查 baseURL、endpoint 和 model ID，429 查配额与限流。
• 5xx 可能来自当前网关或上游；记录 request ID、时间和脱敏响应有助于定位。

动手练习

1. 为四类状态码各写三个核验动作。
2. 把一次历史故障整理成可复现诊断记录。

完成检查

• 排错顺序从低成本核验开始
• 日志没有密钥、完整输入或个人信息

参考与来源

• OpenAI 官方文档：API Reference（platform.openai.com/docs/api-reference）