请求超时问题

由于 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 兼容接口风格）：

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

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

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

  • 如果耗时经常接近或超过 100–120s：建议将该类请求迁移到 openkey.red

  • 如果耗时通常在几十秒内：继续使用 openkey.cloud 更合适（高可用 + 自动迁移）

建议的迁移策略

  • 默认走 openkey.cloud（高可用优先）

  • 对“长耗时请求”做分流：

    • 例如：带思考/推理模型、长报告生成、长上下文任务 → openkey.red

    • 其余常规请求 → openkey.cloud

需要帮助？

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

Last updated