> For the complete documentation index, see [llms.txt](https://docs.openkey.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.openkey.cloud/help/timeout.md).

# 请求超时问题

由于 **openkey.cloud** 主站接入了 **Cloudflare CDN**，在网络边缘层会存在一个**强制请求超时上限**（通常在 **100–120 秒** 左右）。这意味着：当上游模型需要较长时间“思考/生成”时，请求可能会在到达上限时被 Cloudflare **直接中断**，即使模型端仍在处理，也可能出现 **报错但已扣费** 的情况（尤其是带推理/思考的模型，如 GPT-5、Gemini 2.5 等）。

为满足长耗时任务，我们提供了一个不经过 Cloudflare 的备用入口 **openkey.red**，用于尽可能避免 100–120 秒的边缘超时限制。

***

### 两个接入点的区别

#### 1) 主站点：`https://openkey.cloud/`

**特点**

* ✅ 高可用、自动故障迁移
* ✅ 更适合常规请求、稳定性优先的场景
* ⚠️ 受 Cloudflare 影响，存在 **100–120 秒强制超时中断**（请求可能被提前终止）

**适用场景**

* 大多数普通对话、短输出、低延迟调用
* 对可用性要求高、能接受“单次请求不要太久”的业务

***

#### 2) 备用站点（裸节点）：`https://openkey.red/`

**特点**

* ✅ 不走 Cloudflare CDN，**无 100–120 秒强制超时限制**
* ✅ 理论最大超时可到 **600 秒**（取决于你的客户端/网关/上游配置）
* ⚠️ 无高可用与自动迁移，若节点异常需要人工介入修复

**适用场景**

* 长文本生成、复杂推理、慢模型
* 单次请求可能超过 100 秒的任务（例如长链路 Agent、长报告、超长上下文等）

***

### 常见现象与报错

当你看到类似以下错误时，通常意味着请求在边缘层超时被中断：

* `524: A timeout occurred`
* `cf-error`
* 请求在 \~100–120 秒附近结束，但上游仍可能已处理/计费

如果你的业务确实需要更长处理时间，建议将该类请求切换到 **openkey.red**。

***

### 如何切换到 openkey.red

你只需要把“Base URL / Endpoint”从 `openkey.cloud` 换成 `openkey.red`：

* `https://openkey.cloud/` → `https://openkey.red/`

例如（OpenAI 兼容接口风格）：

```bash
curl https://openkey.red/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_KEY" \
  -d '{
    "model": "gpt-5",
    "messages": [{"role":"user","content":"..."}]
  }'
```

> 你的客户端/SDK 也请同时检查自身的超时设置（例如 HTTP client timeout），避免客户端先于服务端超时。

***

### 用日志“耗时”栏目辅助判断是否需要切换

我们已在 OpenKey 的日志页面新增了 **“耗时”** 栏目（单位：秒）。你可以用它来快速判断：

* 如果耗时经常接近或超过 **100–120s**：建议将该类请求迁移到 `openkey.red`
* 如果耗时通常在几十秒内：继续使用 `openkey.cloud` 更合适（高可用 + 自动迁移）

***

### 建议的迁移策略

* **默认走 `openkey.cloud`**（高可用优先）
* 对“长耗时请求”做**分流**：
  * 例如：带思考/推理模型、长报告生成、长上下文任务 → `openkey.red`
  * 其余常规请求 → `openkey.cloud`

***

### 需要帮助？

如果你在切换或使用过程中遇到任何问题（例如仍超时、日志显示异常耗时、扣费与返回不一致等），请把**请求时间点**与**日志记录**发给我们，我们会协助定位与优化。