连接与使用
base URL、认证头,以及怎么区分「配错了」和「坏了」。
该用哪个 base URL?
取决于你的客户端讲哪个协议,与你想用哪个模型无关:
| 客户端讲的协议 | Base URL |
|---|---|
| OpenAI | https://api.routemux.com/v1 |
| Anthropic | https://api.routemux.com |
| Google GenAI / Vertex | https://api.routemux.com/vertex-ai |
为什么 OpenAI 要带 /v1 而 Anthropic 不带
OpenAI 客户端只追加操作路径(/chat/completions),所以 /v1 属于 base URL。
Anthropic 客户端自己会追加 /v1/messages,base URL 再带 /v1 就成了 /v1/v1/messages。
把这两者搞反是最常见的配置错误。
怎么认证?
Authorization: Bearer sk-... 到处都能用。x-api-key(Anthropic 风格)与
x-goog-api-key(Google 风格)同样受理,所以各家 SDK 不用改就能跑。
多个 key 头带相同值没问题。带不同值会返回 400 AMBIGUOUS_API_KEY ——
通常是某个不再使用的字段里还留着一把旧 key。
我能调哪些模型?
GET /v1/models 返回的正是这把 key 能调用的全集。它是元数据查询,不计费。
以它为准:不在返回里的模型,无论客户端怎么配都调不通。
各个错误是什么意思?
| 状态码 | 含义 | 怎么办 |
|---|---|---|
401 | key 缺失、格式错误或已吊销 | 确认以 sk- 开头、首尾无空格 |
402 | 钱包余额为零 | 充值后重试。这不是请求的问题 |
429 | 触发限流 | 降低并发;加大重试只会更糟 |
503 | 上游过载 | 退避后重试 |
400 AMBIGUOUS_API_KEY | 发了两把不同的 key | 清掉没在用的那个头 |
流式能用吗?
能,且不用改。RouteMux 转发 SSE 不缓冲整个响应,并在上游结束后按真实用量结算。