ZergRouter icon

ZergRouter

ZergRouter 是面向 Codex、编程代理和兼容 OpenAI 的应用的 API 路由层,支持选择模型路由、设置密钥每日预算、连接提供商凭证,并通过单一端点监控 Codex 配额。

ZergRouter

什么是 ZergRouter?

ZergRouter 是面向编程客户端和兼容 OpenAI 的应用的路由层。它提供一个端点,用于向可用的模型路由发送请求,同时将 Router API 密钥、上游提供商凭证和订阅身份作为彼此独立的访问路径。

该服务面向需要模型选择、预算控制以及查看已连接 Codex 容量的工作流。它支持由平台管理的访问所支持的路由,也支持使用用户提供商凭证的路由;实际可用的模型取决于经过身份验证的目录、权限、凭证、协议支持和服务容量。

主要功能

单一兼容 OpenAI 的端点

使用 Router 密钥通过 https://zergrouter.com/v1 发送请求,并参考文档中的 cURL、Python、JavaScript、聊天补全和 Responses 示例。该端点兼容受支持的编程客户端和兼容 OpenAI 的应用。

模型路由与回退

从经过身份验证的目录中选择模型,并为受支持的聊天请求配置明确的回退链。模型访问取决于凭证、权限、协议支持和可用的服务容量。

按密钥设置每日预算

为单个 Router 密钥设置 daily_budget_usd 值。当记录的支出达到 UTC 每日预算后,请求会以 429 响应被拒绝,但进行中的请求仍可能增加用量。

Codex 配额监控

连接受支持的订阅身份,并查看 Codex 账户的每周配额、重置日期、剩余容量和数据新鲜度。Router 将订阅访问与提供商 API 凭证分开。

用量可见性

按模型、日期和客户端查看路由用量,包括提供商报告的输入、缓存输入和输出数据(如有)。账户级 Codex 历史记录不会补齐缺失的令牌明细。

凭证分离与控制

创建具有 chat:write、models:read 和 usage:read 等权限的受限 Router 密钥。提供商凭证会单独存储;对于符合条件的故障转移,可以配置同一提供商凭证的优先级,以便在输出开始前尝试其他凭证。

使用场景

  • 在 Codex 中使用 DeepSeek

    将 Codex 的 Responses 提供商指向 Router 端点,并使用目录中可用的模型,例如文档所述的 DeepSeek 路由。已连接账户的配额和重置信息有助于用户在自己的 Codex 账户之间进行选择,但 Router 不会替本地会话做出该选择。

  • 控制应用支出

    向编程客户端提供权限范围最小化的 Router 密钥,而不是上游提供商密钥。配置密钥权限和每日美元预算,然后通过兼容 OpenAI 的基础 URL 发送请求。

  • 连接编程工具

    从 ZTC、Pi、OpenCode 或兼容应用使用同一个路由端点。文档示例涵盖 cURL、OpenAI Python SDK 以及 Vercel AI SDK 的兼容 OpenAI 适配器。

  • 管理多个模型访问路径

    当路由需要用户自己的计费账户时,添加提供商签发的凭证;在可用时,也可以使用平台管理的路由。配置已启用的凭证和同一提供商的优先级,以便在输出开始前尝试符合条件的凭证故障。

Pros and Cons

Pros

  • 为受支持的编程客户端和应用提供单一的兼容 OpenAI 的端点。
  • 将 Router 身份验证与提供商凭证及订阅身份分开。
  • 支持按密钥设置每日预算、受限权限、明确的回退配置和用量查看。
  • 显示 Codex 配额数量、重置日期和数据新鲜度,方便用户比较已连接的账户。
  • 在有符合条件的额度时,提供有文档说明的免银行卡 DeepSeek 试用。

Cons

  • 经过身份验证的目录、权限、协议支持、提供商凭证和共享服务容量可能会限制可用模型。
  • 网站未提供通用定价页面;必须在经过身份验证的 ZergAI 和 Router 账户区域中查看计费信息和当前可用的试用状态。
  • 订阅监控不会自动连接 Claude 登录账户,也不会在会话期间切换本地 Codex 账户。

FAQ

如何开始使用 ZergRouter?

使用 ZergAI 登录,在 API keys 区域创建 Router API 密钥,并安全保存完整密钥,因为它在创建时以及轮换时各显示一次。将受支持的客户端或兼容 OpenAI 的应用指向 https://zergrouter.com/v1。

ZergRouter 可以与 Codex 一起使用吗?

可以。使用经过身份验证的 /v1/models 端点列出的、具备 codex_responses 能力的模型,然后按照 Codex 设置说明操作。资料指出 Modal DeepSeek 路由支持原生 Responses 转发,但可用性取决于经过身份验证的目录和账户权限。

Router API 密钥是否包含模型订阅?

不能。Router 密钥用于验证路由请求;它不包含模型订阅,也不能替代提供商凭证。Codex 订阅和提供商 API 密钥仍是彼此独立的访问路径。

DeepSeek 和提供商请求如何获得费用支持?

有文档说明的免银行卡 DeepSeek 试用为每个经过验证的电子邮箱提供一次 $1 使用额度或 500 万个令牌,以先达到者为准;通常会先达到金额上限。付费 DeepSeek 访问需要银行卡,并按文档所列路由费率计量;使用您自己的提供商密钥的路由则由相应提供商计费。

ZergRouter 会自动切换我的本地 Codex 账户吗?

不会。Router 会显示已连接 Codex 账户的配额和重置时间,但本地 Codex 会话使用哪个账户由您选择。在托管的 ZTC 中,系统可以在每轮开始前,根据模型可用性和配额信息选择一个已连接的订阅账户。

Quick Facts

类别
开发者工具
主要用户
使用编程代理、Codex 或兼容 OpenAI 的应用的开发者
端点
https://zergrouter.com/v1
列出的受支持客户端
ZTC、Codex、Pi、OpenCode 和兼容 OpenAI 的应用
DeepSeek 试用
可用的免银行卡额度可能提供 $1 使用额度或 500 万个令牌,以先达到者为准;每个经过验证的电子邮箱限一次
付费 DeepSeek 路由
输入 $0.30/100 万个,缓存输入 $0.03/100 万个,输出 $1.20/100 万个,受每月用量上限约束