Responses API 错误处理
Responses API 的错误处理重点是区分请求格式错误、模型能力不支持、工具调用失败和上游服务异常。
常见问题
| 问题 | 处理方式 |
|---|---|
input 格式不正确 | 检查字符串输入和结构化消息不要混用错误 |
| 模型不支持某个字段 | 移除该字段或更换支持该能力的模型 |
| 工具参数不完整 | 收紧 parameters Schema，并在业务侧做校验 |
| 流式输出中断 | 支持客户端重试，但先确认业务是否幂等 |
返回 429 | 降低并发并实施指数退避 |
排查建议
- 保留
Request-Id和响应中的traceId。 - 记录脱敏后的请求体，尤其是
model、input、tools和reasoning。 - 工具调用失败时，同时记录工具入参和业务系统返回码。