请求头与追踪
查看实际支持的鉴权、会话、请求追踪与路由响应头。
请求头#
| 请求头 | 作用 |
|---|---|
Authorization | 网关 API Key Bearer 鉴权 |
x-api-key / x-goog-api-key | Anthropic / Gemini 鉴权 |
X-Request-Id | 可选追踪 ID,最长 128 字符:字母、数字、点、下划线、冒号或连字符 |
x-conversation-id | Chat Completions 的会话历史 ID |
x-conversation-reset | 重置会话历史 |
anthropic-version / anthropic-beta | 匹配原生 Anthropic 上游的协议头 |
响应头#
上游/账号与路由细节仅在管理员启用 EXPOSE_UPSTREAM_ROUTE_HEADERS=true 时暴露;不要依赖默认响应一定包含这些调试头。
| 响应头 | 作用 |
|---|---|
X-Request-Id | 实际关联本次 HTTP 请求的 ID |
x-upstream-provider-id / x-upstream-account-id | 所选上游与账号(适用路径) |
x-upstream-route-role | primary / backup |
x-routing-strategy | 路由策略标识 |
x-conversation-cache | 会话历史的 hit / miss / reset |
x-token-count-source | Token 计数接口的 estimated |
Retry-After | 适用的限流等待时间 |
代理没有用于通用幂等去重、客户端强制选择上游或跨租户计费的请求头。上游与租户选择遵循服务器保存的权限和路由配置。