> ## Documentation Index
> Fetch the complete documentation index at: https://omnirelay.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 统一网关

> OmniRelay 在你的请求与模型之间做了什么。

应用只需调用一个入口。OmniRelay 校验 API Key，在你的空间内解析模型，确认该模型当前可用，然后计量并记录本次调用。

经过核验的 GPT、Claude、DeepSeek 和 GLM 文本路由按工作空间开通。自己的 `GET /v1/models` 返回精确 ID 与 `mode: live`。目录展示或连接检查成功不会自动开通模型。

```mermaid theme={null}
flowchart LR
  A[你的应用] -->|Bearer API Key| B[OmniRelay API]
  B --> C{模型已启用?}
  C -->|是| D{模型可用?}
  D -->|是| E[模型服务方]
  E --> F[用量 + 流水]
  C -->|否| X[404 model_unavailable]
  D -->|否| Y[503 channel_unavailable]
```

## 请求生命周期

**1. 认证**

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

**2. 限流**

先检查 Key 的 IP 白名单，再检查每分钟次数与并发上限：默认整个工作空间每分钟 120 次、并发 5 个。详见[限流](https://omnirelay.ai/docs/cn/overview/rate-limits.md)。

**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` 标明此模式，由模型服务方检查上下文能否放入。
应用自动重试前请阅读[用量与计费](https://omnirelay.ai/docs/cn/general/usage-billing.md)。

## 服务地址

| 用途 | URL |
| - | - |
| API | `https://api.omnirelay.ai` |
| OpenAI SDK `base_url` | `https://api.omnirelay.ai/v1` |
| 官网与控制台 | `https://omnirelay.ai` |

API 域名只提供 `/v1/*` 与 `/health`，其余路径返回 `404`。

> [!NOTE]
>
> 当前不启用自动付费重试或故障切换。新模型需先完成能力与计费核验，再按工作空间开通。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.