Relay

快速开始 · /docs/open-api

OpenAI 兼容接口

Relay 提供 OpenAI 兼容接口:Chat Completions、模型列表与 Responses 风格调用都走同一套鉴权。

鉴权

所有请求在 Authorization 头里带 Bearer Token:Authorization: Bearer sk-relay-xxxxxxxx。

不要把 Key 提交进代码仓库;服务端之间调用建议用环境变量注入,泄露后立即在控制台吊销并重建。

Authorization: Bearer sk-relay-xxxxxxxx
Content-Type: application/json

Chat Completions

POST /v1/chat/completions,请求体与 OpenAI 官方一致:model、messages、temperature、max_tokens、stream。流式返回用 SSE,格式与官方相同。

POST https://router.martianc.com/v1/chat/completions
{
  "model": "gpt-5.6-sol",
  "messages": [{"role": "user", "content": "用一句话介绍中转站"}],
  "stream": false
}

模型列表

GET /v1/models 返回当前可用模型。模型广场(/models)展示的价格与可用性就来自这个接口与倍率配置。

curl https://router.martianc.com/v1/models -H "Authorization: Bearer sk-relay-xxxxxxxx"

错误码

401:密钥无效或已吊销,检查 Authorization 头与控制台的密钥状态。

402:余额不足,先充值。429:触发限流,按 Retry-After 等待后重试,见限流文档。

500 / 502 / 503:上游或路由异常,带 request-id 重试一次;持续失败走自动兜底或联系支持。


上一页 / 下一页: ← 快速开始:接入 API · 限流与配额 →

先充一点,跑起来再说

余额不过期、用多少扣多少。拿一个 API Key,把现有工具的 base URL 指过来就能试。

Top up

Every Request Takes The Best Route

每次请求都按模型、延迟与成本实时选路:上游抖动自动换路,失败自动重试, 你点的模型就是实际跑的模型。

看看路由是怎么工作的 →