响应与计费
request_id 与排查
用 request_id 定位调用失败和上游错误。
遇到问题先保留 request_id
网关请求会尽量在响应头带上 X-Request-Id。OpenAI 和 Gemini 风格错误体也会返回 request_id；Anthropic 风格错误请看响应头。
在哪里看到
Prop
Type
错误响应示例
{
"error": {
"message": "missing API key",
"type": "authentication_error",
"code": "api_key_missing",
"request_id": "req_..."
},
"request_id": "req_..."
}{
"type": "error",
"error": {
"type": "authentication_error",
"message": "missing API key",
"code": "api_key_missing"
}
}{
"error": {
"code": 401,
"message": "missing API key",
"status": "UNAUTHENTICATED"
},
"request_id": "req_..."
}排查顺序
先记录 request_id
复制响应头 X-Request-Id，不要只截图错误文案。
再看协议错误字段
OpenAI / Anthropic 看字符串错误码，例如 api_key_missing、insufficient_balance、model_not_found；Gemini 看 error.status 和 error.message。若出现 usage_missing 或 usage_invalid，说明该响应没有满足真实 usage 或安全估算条件。
最后对照协议页面
确认 Header、路径、模型商品 public model id 和流式方式是否属于当前 API family / 调用入口。
request_id 不是密钥
request_id 可以用于排查沟通。不要在截图、日志或 issue 里暴露用户 API Key、上游 provider Key 或其他 secret。
最后更新于