协议

兼容 OpenAI 的 API

如果你的代码已经在调用 OpenAI API，那它已经能调用 RelayRouter。把客户端指向 https://relayrouter.io/v1，用 RelayRouter 密钥作为 API key，发送和今天完全一样的请求体即可。网关接受 OpenAI 的请求格式，路由到密钥所属的分组，并返回 OpenAI 的响应格式，流式输出同样是 server-sent events。

Base URL 与端点

https://relayrouter.io/v1 把它设为任意 OpenAI 客户端的 base URL，端点路径由 SDK 自动拼接。

方法	路径	说明
POST	/v1/chat/completions	对话补全，stream: true 流式，工具调用与 JSON 模式原样透传给模型
POST	/v1/responses	Responses API，Codex 类客户端使用的格式
POST	/v1/images/generations	图像生成，例如 gpt-image-2
GET	/v1/models	你的密钥可调用的模型列表

鉴权： Authorization: Bearer <你的 RelayRouter 密钥>。密钥决定分组，分组决定可用模型与费率。

代码

Python

main.pypython

from openai import OpenAI

client = OpenAI(
    api_key="your-relayrouter-key",
    base_url="https://relayrouter.io/v1",  # the only change
)

res = client.chat.completions.create(
    model="gpt-6-astra",
    messages=[{"role": "user", "content": "Hello!"}],
    stream=False,
)
print(res.choices[0].message.content)

TypeScript

index.tstypescript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.RELAYROUTER_API_KEY,
  baseURL: "https://relayrouter.io/v1",
});

const stream = await client.chat.completions.create({
  model: "gpt-6-astra",
  messages: [{ role: "user", content: "Hello!" }],
  stream: true,
});
for await (const chunk of stream) process.stdout.write(chunk.choices[0]?.delta?.content ?? "");

cURL

terminalbash

curl https://relayrouter.io/v1/chat/completions \
  -H "Authorization: Bearer $RELAYROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-6-astra", "messages": [{"role": "user", "content": "Hello!"}]}'

使用这一协议的分组

一把密钥属于一个分组。在控制台为下面任一分组创建密钥；模型页有全部分组与模型的实时费率。

分组	费率	模型（示例）
GPT 标准	每 $1 标准用量 ¥0.6，约低于 ¥6.8/$ 参考价 91%	codex-auto-review, gpt-5.2, gpt-5.2-2025-12-11, gpt-5.2-chat-latest, gpt-5.2-pro 等共 26 个
Codex 快速	每 $1 标准用量 ¥0.75，约低于 ¥6.8/$ 参考价 89%	codex-auto-review, gpt-4o, gpt-4o-mini, gpt-5.2, gpt-5.2-2025-12-11 等共 29 个
MiniMax	直连按 token 计价	MiniMax-M2.7
Z.ai	直连按 token 计价	glm-5.1, glm-5.2
GPT 图像	每 $1 标准用量 ¥1.25，约低于 ¥6.8/$ 参考价 82%	gpt-image-2
Kimi	直连按 token 计价	kimi-k2.6
GPT Azure	每 $1 标准用量 ¥2.38，约低于 ¥6.8/$ 参考价 65%	codex-auto-review, gpt-5.2, gpt-5.2-2025-12-11, gpt-5.2-chat-latest, gpt-5.2-pro 等共 18 个
OpenAI 稳定版	每 $1 标准用量 ¥2.8，约低于 ¥6.8/$ 参考价 59%	gpt-4.1, gpt-4.1-mini, gpt-4.1-nano, gpt-4o, gpt-4o-mini 等共 29 个

可直接使用的工具

OpenAI SDK (Python, TypeScript, .NET, Java, Go): 设置 base_url 与 api_key
LangChain ChatOpenAI: openai_api_base=https://relayrouter.io/v1 (指南)
LiteLLM: model=openai/<id>，api_base=https://relayrouter.io/v1
Cursor: Override OpenAI Base URL (指南)
Cline / Roo Code: OpenAI Compatible 提供方 (指南)
Dify: OpenAI-API-compatible 模型供应商 (指南)

常见问题

除了 base URL 和密钥还要改什么？

不需要。请求和响应体都是 OpenAI 格式；流式、工具调用、JSON 模式和 usage 字段与直连 OpenAI 一致。只有换成非 OpenAI 模型时需要改模型名。

通过兼容 OpenAI 的端点能调用哪些模型？

所有协议为 OpenAI 的分组里的模型：GPT 系列（gpt-6-astra、gpt-5.6-sol、gpt-6.1-sol 等）、Kimi、GLM、MiniMax 以及 gpt-image-2。模型页标注了每个分组的协议并列出其模型。

怎么计费？

按 token 从预付余额扣除，费率由密钥所属分组决定。没有平台费、订阅和最低消费，失败请求不计费。

有速率限制吗？

每个账户有并发上限，控制台可见；上游提供方对各模型有自己的限制。需要更高并发请联系客服。

其他协议

指南