跳转到主要内容
应用只需调用一个入口。OmniRelay 校验 API Key,在你的空间内解析模型,确认该模型当前可用,然后计量并记录本次调用。 经过核验的 GPT、Claude、DeepSeek 和 GLM 文本路由按工作空间开通。自己的 GET /v1/models 返回精确 ID 与 mode: live。目录展示或连接检查成功不会自动开通模型。

请求生命周期

1

认证

对 Authorization: Bearer 中的 API Key 取哈希并匹配有效 API Key。已撤销的 API Key 立即返回 401 unauthorized。
2

限流

先检查 Key 的 IP 白名单,再检查每分钟次数与并发上限:默认整个工作空间每分钟 120 次、并发 5 个。详见限流。
3

解析模型

model 必须在 API Key 所属空间内处于启用状态,否则返回 404 model_unavailable。
4

检查可用性

该模型当前必须可供真实调用,否则返回 503 channel_unavailable。
5

计量与记录

真实请求先原子化预留钱包和 Key 预算,再派发一次调用。 有效最终用量按冻结费率结算并释放未用预留;派发后结果不明确时保持待对账, 不自动发起付费重试或退款。 真实预留预算不足时,在联系模型服务方前返回 402。

真实模型限制

下文示例为 GPT 5.4 Mini。多数已接入文本模型最多输出 128,000 Token、默认 32,000(Gemini 3.1 Pro Preview 和 Gemini 3.6 Flash 最多 65,536);DeepSeek V4 Pro、GLM 5.3 和 Kimi K3 默认且最多 4,096;GPT 5.4 Mini 默认 64、最多 256。SSE 与推理内容支持按模型检查,不支持自动付费故障切换。 gpt-5.4-mini 支持文本/system 消息与 JSON/SSE 响应,默认输出 64、最大 256 Token。 推理强度显式为 none;GPT 5.4 Mini 支持函数工具、JSON object/schema 和无状态 Responses HTTP/SSE,严格工具、图片和采样仍关闭。 物理联合上下文为 400,000 Token,网关分别按请求大小的输入上界(不超过输入硬上限)和请求输出上限预留, 最高预留金额随工作区价格设置变化,不是最终费用。模型详情以 provider-context-ceiling 标明此模式,由模型服务方检查上下文能否放入。 应用自动重试前请阅读用量与计费。

服务地址

API 域名只提供 /v1/* 与 /health,其余路径返回 404。
当前不启用自动付费重试或故障切换。新模型需先完成能力与计费核验,再按工作空间开通。