响应与计费
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、usage_missing；Gemini 看 error.status 和 error.message。
最后对照协议页面
确认 Header、路径、模型名和流式方式是否属于当前协议。
request_id 不是密钥
request_id 可以用于排查沟通。不要在截图、日志或 issue 里暴露用户 API Key、上游 provider Key 或其他 secret。
最后更新于