AI 接口报错求助模板，附两份 429 交接单和本地演示

AI 接口报错后，求助内容里把发生时间、调用方式和错误字段一起留下，会更容易继续查。尤其是429：OpenAI官方错误说明里既有请求节奏相关的限制，也有账单、花费或用量限制，不能只凭这个数字决定下一步。

这份模板可以直接复制。填不知道的地方时，就写“未获得”“未提供”或“未验证”：

问题一句话：
发生时间与时区：
工具/客户端/SDK及版本：
产品面与登录方式：API / ChatGPT / 其他，分开写
线路或配置别名：不贴网址、域名或凭证
模型名、请求类型（如适用）：
最小可公开输入与复现步骤：
预期结果 / 实际观察：
HTTP状态：实际值；没拿到响应就写未获得
error.code / error.type：响应原文；没有就写未提供
服务端请求ID：确实收到且确认可公开的值
Retry-After：原值；没有就写未提供
已检查的事实及结果：没验证的不能写成已排除
还缺什么：

不需要把授权头、Cookie、API key、验证码或整份日志贴出来。包内 blank-handoff.md 是完整空白版，prompt.txt 可以和填好的单子一起交给 AI：先列已知事实，再给最能区分原因的一项检查；证据不够时先补关键缺项。

下面两张卡来自同一脚本的本地模拟响应，演示该保留哪些字段。所有错误内容和请求ID都由样例构造，不是线上接口记录：

两次都是429，但 code/type 和 Retry-After 不一样。第二例没有这个响应头，就记“未提供”，不替它推算等待秒数。这两例也没有覆盖全部429原因。

想实际跑一次交接单生成流程，解压附件后，用 Python 3.9+ 在材料目录运行，无第三方依赖：

python demo.py
python verify.py

本地实际用 Python 3.12.14 运行，第一条命令输出：

generated=3 requests=3 http_errors_handled=2 thread_closed=True

脚本在本机回环地址的随机端口启动临时服务器，发送两次429样例请求和一次200控制请求，每个场景一次，不重试。两个错误响应仍会读取 JSON 和选定响应头；200只是本地控制，不代表模型调用成功。

生成的三份单子在 demo-output 的三个场景子目录中，各叫 handoff.md。已存在的输出目录不会被覆盖，再跑时可用 python demo.py another-new-output。验证记录的可选输出也拒绝覆盖旧文件。

真实问题用空白模板人工填写并复查。演示脚本不读取真实日志，只做固定请求和有限字段摘录，不能拿来当通用脱敏工具。连接失败时可能没有HTTP状态或请求ID；没有ID也不能反推服务端没收到请求。中转可能自己生成或改写响应，套用上游错误说明前，要先确认字段来自哪里。

13项本地检查与ZIP解压复跑均通过，记录在 VERIFICATION.json。完整包还放了三份已填写的模拟交接单，方便先看格式：

下载空白模板、提示词、三份模拟交接单与可运行脚本（ZIP，9个文件）

参考：OpenAI《API overview—Debugging requests》《Error codes》《Rate limits》及官方支持说明，2026-10-23查阅。