跳到文档内容
瑞云智能
开发文档
进阶指南请求头与追踪

请求头与追踪

查看实际支持的鉴权、会话、请求追踪与路由响应头。

请求头#

请求头作用
Authorization网关 API Key Bearer 鉴权
x-api-key / x-goog-api-keyAnthropic / Gemini 鉴权
X-Request-Id可选追踪 ID,最长 128 字符:字母、数字、点、下划线、冒号或连字符
x-conversation-idChat 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-roleprimary / backup
x-routing-strategy路由策略标识
x-conversation-cache会话历史的 hit / miss / reset
x-token-count-sourceToken 计数接口的 estimated
Retry-After适用的限流等待时间

代理没有用于通用幂等去重、客户端强制选择上游或跨租户计费的请求头。上游与租户选择遵循服务器保存的权限和路由配置。

搜索文档

推荐阅读

推荐阅读