快速开始 · /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/jsonChat 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 · 限流与配额 →