给聚合站提 bug 该带什么料：请求 ID、模型名、时间戳与请求体形状
本文提供了一份针对无登录LLM API聚合站的最小可复现报障模板，包括请求ID、模型名、时间戳和请求体形状，帮助客服仅凭一条调用快速定位问题，避免账号追溯。
当你在使用无登录的 LLM API 聚合站时，遇到调用失败或返回异常，如何高效报障就变得很重要。由于没有账号体系，客服无法通过你的账号历史来复现问题，因此你需要提供足够的信息，让客服仅凭一条调用就能定位问题。下面是一份最小可复现的报障模板，包含四个关键要素：请求 ID、模型名、时间戳和请求体形状。
为什么需要这些信息
无登录聚合站通常通过 API key 来识别用户，但客服可能无法直接访问你的完整调用历史。提供请求 ID 可以让客服在日志中精准定位到某一次调用；模型名帮助确认路由和计费是否正确；时间戳能缩小日志检索范围；请求体形状则让客服了解你发送的数据结构，而不需要你泄露完整的请求内容。
最小可复现报障模板
请按以下格式提供信息：
- 请求 ID：通常位于响应头或响应体中，例如
X-Request-ID。如果找不到，请描述响应中的唯一标识字段。 - 模型名：你调用的模型名称，例如
claude-3-sonnet或gpt-4。 - 时间戳：调用发生的时间，建议使用 ISO 8601 格式并包含时区，例如
2025-03-23T14:30:00+08:00。 - 请求体形状：不要粘贴完整请求体，只需描述结构。例如：
messages数组包含 3 条消息，最后一条角色为user，max_tokens设置为 1000。如果涉及文件或图片，请说明类型和大小。
示例
请求 ID: req_abc123
模型名: gpt-4
时间戳: 2025-03-23T14:30:00+08:00
请求体形状: messages 数组含 2 条消息（system 和 user），max_tokens=500，temperature=0.7
问题描述: 返回 500 错误，响应体为 {"error":"internal server error"}避免常见错误
- 不要只写“调用失败”，而没有具体信息。
- 不要粘贴包含敏感信息的完整请求体，尤其是 API key 或用户数据。
- 不要使用模糊的时间描述，如“刚才”，尽量提供精确时间。
- 如果问题可复现，请说明复现步骤和频率。
总结
提供请求 ID、模型名、时间戳和请求体形状，能让客服快速定位问题，减少来回沟通。即使是无登录的聚合站，也能通过一条调用信息高效解决你的报障。