RouteMux Docs

连接与使用

base URL、认证头,以及怎么区分「配错了」和「坏了」。

该用哪个 base URL?

取决于你的客户端讲哪个协议,与你想用哪个模型无关:

客户端讲的协议Base URL
OpenAIhttps://api.routemux.com/v1
Anthropichttps://api.routemux.com
Google GenAI / Vertexhttps://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 能调用的全集。它是元数据查询,不计费。 以它为准:不在返回里的模型,无论客户端怎么配都调不通。

各个错误是什么意思?

状态码含义怎么办
401key 缺失、格式错误或已吊销确认以 sk- 开头、首尾无空格
402钱包余额为零充值后重试。这不是请求的问题
429触发限流降低并发;加大重试只会更糟
503上游过载退避后重试
400 AMBIGUOUS_API_KEY发了两把不同的 key清掉没在用的那个头

流式能用吗?

能,且不用改。RouteMux 转发 SSE 不缓冲整个响应,并在上游结束后按真实用量结算。

On this page