跳转到内容

Provider 设置

Provider 是一个命名上游配置。Provider 名称是你的标签;provider protocol 控制出站 wire 行为。

[providers.openai]
protocol = "openai_responses"
base_url = "https://api.openai.com"
api_key = "..."
字段含义
`protocol`出站 provider 协议:openai_responsesopenai_chat_completionsanthropic_messages
`base_url`上游 provider origin。ProxAI 会构造协议 path。
`api_key`真实上游 key。按 provider-owned auth headers 发送。
`compatibility`可选兼容模式,用于配置 provider-specific 行为。
[routing.default_provider_names]
openai_responses = "openai"
openai_chat_completions = "openai"

只有没有显式 route 匹配时才使用 defaults。见行为契约

[[routing.routes]]
request_protocol = "openai_responses"
match_kind = "exact"
model_pattern = "my-model"
provider = "anthropic_upstream"
upstream_model = "claude-like-model"

当同一个 model pattern 需要按 endpoint 表现不同时,使用 request_protocol

Provider 协议上游认证 header
openai_responses / openai_chat_completionsAuthorization: Bearer <api_key>
anthropic_messagesx-api-key: <api_key>

客户端传入的 Authorization 不作为上游 provider 认证。见客户端接入