快速开始 占位示例

将任意 OpenAI SDK 的 base_url 指向无限中转,即可无缝切换。以下示例中的域名与密钥均为占位值,正式接入地址将在控制台发放。

PLACEHOLDER# 一行改完,其余代码不用动
curl https://api.relay.example/v1/chat/completions \
  -H "Authorization: Bearer $RELAY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "relay-demo-chat",
    "messages": [{"role": "user", "content": "你好,无限中转"}]
  }'
复制示例

鉴权与令牌

令牌在控制台创建,支持额度上限、模型白名单与过期时间。请求时通过 Authorization: Bearer 头传递。

Chat Completions

兼容 /v1/chat/completions:支持流式输出(SSE)、function calling、多模态消息。参数与响应结构与 OpenAI 官方一致。

模型列表

通过 /v1/models 获取当前账号可调用的全部模型,含上下文长度与能力标签。

分站与自主定价 占位示例

一键开设分站后,主站聚合的语言 / 图形 / 视频模型将自动下发到你的分站;每个模型可单独设置售价,差价即利润。你也可以接入自有渠道,上新模型到分站独享列表,与下发模型同池鉴权、同池计费。

PLACEHOLDER# 分站同样走 OpenAI 兼容协议,只是换成你的域名与定价
curl https://your-branch.relay.example/v1/chat/completions \
  -H "Authorization: Bearer $BRANCH_KEY" \
  -d '{"model": "relay-demo-chat", "messages": [...]}'

计费说明

按 token 计费,输入输出分开计价;图像按张、语音按时长。账单实时同步至控制台。

错误码

沿用 OpenAI 错误结构 { error: { message, type, code } },另增中转特有错误:通道不可用、额度不足、模型未上架。