仅限 API 调用

该线路仅用于 API 调用

当前线路已启用缓存型 API 转发能力, 仅接受受支持的 API 请求(例如 /v1/models、/v1/chat/completions、/v1beta/models/gemini-2.5-pro:streamGenerateContent), 不提供网页访问能力。

当前请求已被拒绝

方法
GET
路径
/
原因
路径不属于当前线路支持的 API 路径范围

可用路径示例

  • /v1/models
  • /v1/chat/completions
  • /v1beta/models/<model>:streamGenerateContent
  • 以及其他上游支持的 /v1/... 或 /v1beta/... 端点

如何正确使用此线路

  • 把当前域名填写到任意支持 OpenAI 兼容接口的 LLM 客户端中(软件应用、脚本、插件、Web 应用均可), 作为 Base URL / API 地址。
  • 请求路径需使用上游原生 API 规范, 例如 OpenAI 兼容接口使用 /v1/..., Google Gemini 接口可使用 /v1beta/...; API Key、模型名、消息体等参数与直接调用原始上游保持一致。

当前线路的 Base URL

把下方地址作为 Base URL 填写到任意支持 OpenAI 兼容接口的客户端中即可使用。

若你的客户端会在 Base URL 末尾自动补上 /v1, 请在复制后手动去掉末尾的 /v1 再填写。

https://relay-cache.sharkielab.com/v1
点击「复制」按钮即可将上方地址复制到剪贴板。

断点续传机制

客户端因网络抖动、移动端切后台、页面刷新、进程退出、主动关闭连接等任意原因中断时, 此线路不会终止正在进行的上游生成, 上游会继续产生完整响应。

在上游响应结束前, 客户端用完全相同的参数重新发起同一请求, 即可接入正在进行的这次响应流, 从当前生成进度继续接收剩余内容, 而不是让上游重新生成一次, 也不会再扣一次费。

「完全相同」指完整请求路径(含 query string)、API Key、请求体字节全部一致; 任一项不同都会被识别为新请求, 不会命中续传。

断点续传与完成态缓存能力仅对 POST 请求生效。其余请求方法始终实时转发至上游, 不参与缓存。

完成响应缓存

上游响应结束后, 结果会被缓存一段时间; 期间用完全相同的参数再次发起请求, 将直接命中缓存并立即返回, 不再触达上游。

成功响应
缓存 1 小时, 期间相同请求直接返回已缓存的完整结果。
错误响应
HTTP 状态非 200 或响应未完整接收时不缓存; 已完整接收的 HTTP 200 响应仍按成功响应缓存, 不受模型输出结果影响。

缓存命中的判定条件与断点续传完全一致 —— 路径、API Key、请求体字节必须全部一致。

使用限制与注意事项

  • 失去主动中断权: 上游生成在客户端断开后仍会继续, 客户端一侧「关闭连接」不会真正停止上游计费, 请按需求使用本线路。
  • 仅 POST 请求享有缓存: 断点续传与完成态缓存仅对 POST 请求生效(如 /v1/chat/completions)。GET 请求(如 /v1/models)始终实时转发至上游, 确保模型列表等数据保持最新。
  • 路径限制: 仅当前线路支持的 API 路径会进入此线路, 当前明确支持 /v1/... 与 /v1beta/...; 其他路径都会被当作非 API 请求直接拒绝。
  • 不是网页入口: 浏览器直接访问本地址始终只会看到此说明页。