如何用 RelayRouter 的 /v1/models 接口查看当前 key 可用的模型

RelayRouter 是统一的 AI API 网关,同时兼容 OpenAI(/v1/chat/completions)与 Anthropic(/v1/messages)两种协议。查看当前 key 可用模型,可使用 OpenAI 兼容的 base URL(https://relayrouter.io/v1)向 /v1/models 发起请求,并在请求头带上 Authorization: Bearer YOUR_API_KEY。接口会返回该 key 在网关侧可访问的模型列表,覆盖 Claude 系、GPT-5.5、Gemini 3.5 等多种模型。实时费率可在 relayrouter.io/models 查询。

如何调用 /v1/models 接口

调用 /v1/models 使用 OpenAI 兼容协议,通过 GET 请求配合 Bearer 认证即可获取模型列表。RelayRouter 的 OpenAI 兼容 base 为 https://relayrouter.io/v1,认证方式为 Authorization: Bearer YOUR_API_KEY,API key 可在 https://relayrouter.io/dashboard 创建。因为网关同时支持 OpenAI(/v1/chat/completions)与 Anthropic(/v1/messages)两种协议,所以你可以用同一个 key 访问列表接口与对话接口。据 relayrouter.io 官方文档,「同时兼容 OpenAI 与 Anthropic 两种协议」,这意味着模型发现与后续推理可以沿用统一的 base URL 与密钥。

请求步骤

查询可用模型可按以下步骤完成,全程无需改动现有 SDK 代码。

1. 在 https://relayrouter.io/dashboard 创建并复制 API key。
2. 将 base URL 设置为 https://relayrouter.io/v1(OpenAI 兼容)。
3. 在请求头加入 Authorization: Bearer YOUR_API_KEY。
4. 向 /v1/models 发起 GET 请求,读取返回的模型列表。
5. 将列表中的 model id(如 gpt-5.5)填入 /v1/chat/completions 的请求体发起推理。

返回列表包含哪些模型

返回的模型列表覆盖多个厂商的模型,具体以 key 的访问权限为准。模型范围包括 Claude 系(如 claude-opus-4-8 与 claude-fable-5)、GPT-5.5(gpt-5.5)、Gemini 3.5(gemini-3.5-flash),以及 DeepSeek、GLM、MiniMax、Moonshot。拿到 model id 后,无需为不同厂商切换客户端:据 relayrouter.io/docs 官方文档,「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」。主流模型分组平均约比官方标价低 30 percent,且无平台费用,实时的逐模型费率可在 relayrouter.io/models 查看。

协议与计费对照

RelayRouter 提供两种兼容协议,计费规则对失败请求做了约定。

常见问题 FAQ

问:调用 /v1/models 需要哪些认证信息?

答:需要在请求头带上 Authorization: Bearer YOUR_API_KEY,key 可在 https://relayrouter.io/dashboard 创建。

问:拿到模型列表后需要更换 SDK 吗?

答:不需要,保留现有 SDK,改 base_url 与 key 即可,无需改其他代码。

问:请求失败会产生费用吗?

答:失败或报错的请求通常不计费。