Martin-hhht

为什么我们构建这个网关

如果你想使用中国前沿模型——DeepSeek、Kimi、Qwen、MiniMax、Doubao——作为国际开发者，你很快会遇到摩擦：每个提供商都有自己的认证方案、自己的计费怪癖，而且有几个要求中国大陆的支付方式或企业认证。我们在生产环境中自己运行这些模型，因此构建了我们想要的网关：一个兼容 OpenAI 的端点、一个 API 密钥，以及跨 16 个中国大模型的自动路由。

结果就是 HOUJIAYAN API（https://api.houjiayan.com）。以下是我们的架构笔记。

架构

Client (any OpenAI SDK)
   │  https://api.houjiayan.com/v1
   ▼
Cloudflare (WAF / rate limiting / TLS)
   ▼
NewAPI (forked) — channels, API keys, quota, billing
   │        │
   ▼        ▼
Custom smart    Custom payment bridge (standalone service)
router          ├─ WeChat Native Pay (APIv3)
(quality /      └─ NOWPayments (USDT-TRC20)
balanced /
cost tiers)
   │
   ▼
16 upstream model channels (11 enrolled in auto-routing)


Gateway: a fork of NewAPI.NewAPI 是中国大模型生态中广受欢迎的成熟开源 API 网关。我们保留了其通道抽象、令牌管理和配额核算功能，并自定义定价，使费率与上游官方定价完全一致——不加价——控制台中提供实时价格表。费率低至 ¥1.00 / 1M tokens。

Smart router: a custom stateless service.除了标准的 `/v1/chat/completions`（你可以直接固定使用 16 个模型中的任意一个）之外，我们还提供 `POST /v1/auto/chat/completions`，包含三个路由层级：

- `quality`（默认）：为任务类别选择质量最高的模型；
- `balanced`：质量与成本的最佳平衡点；
- `cost`：最便宜的可用模型，适合批量工作负载。

路由器根据任务特征（上下文长度、代码 vs. 散文、预期输出长度）对候选通道进行打分，对照精心策划的质量层级表。16 个模型中有 14 个参与自动路由池。上游失败时，它会降级到次优通道。

Payment bridge: the hardest part.NewAPI 不处理支付，因此我们构建了一个独立的 pay_bridge 服务：

- 针对国内用户的微信 Native Pay APIv3（原生 QR 码订单 → 签名回调 → 签名 epay 式通知进入网关）；
- 针对中国大陆以外用户的 NOWPayments（USDT-TRC20）（IPN 回调 → 外汇转换 → 充值）。

支付桥通过签名回调协议与网关通信，使网关能够原生地充值账户——无需双重写入。

经验教训

1. 微信新的“平台公钥”模式。新商户账户被强制使用公钥验证（密钥 ID 以 `PUB_KEY_ID_` 为前缀），而不是旧的平台证书链。几乎所有教程和 SDK 示例仍然假设使用证书模式。如果你的回调签名验证在新商户账户上失败，这就是原因。
2. `base_url` 必须以 `/v1` 结尾。OpenAI SDK 会将路径拼接到 `base_url` 上，因此仅使用 `https://api.houjiayan.com` 会返回 404。我们在边缘添加了温和的重定向，并在文档顶部放置了正确的代码片段：

Enter fullscreen mode Exit fullscreen mode


python
from openai import OpenAI
client = OpenAI(api_key="sk-...", base_url="https://api.houjiayan.com/v1")




3. 跨提供商的使用量核算。上游报告令牌使用量的方式不一致（有些仅在流结束时报告）。我们将核算标准化为网关解析的使用量，并为从未报告的流提供本地估算回退，并保留每个请求的审计细节。

访问与定价（完整披露）

- 端点：`https://api.houjiayan.com/v1`（兼容 OpenAI）；自动路由位于 `POST /v1/auto/chat/completions`
- 模型：16 个中国大模型可直接访问（DeepSeek V4 Pro/Flash、Kimi K3、MiniMax M3、Qwen3.6/3.7 系列、Doubao Seed Code 等）；11 个在自动路由池中
- 定价：与上游官方定价完全一致，不加价；控制台中提供实时价格表；起价 ¥1.00 / 1M tokens
- 注册赠金：¥6.6（约 $1）免费试用额度；持续使用有效；仅在连续 7 天无 API 调用且无登录后收回
- 充值：微信支付（最低 ¥50，5.5% 服务费）；USDT-TRC20（最低 $25，5% 服务费，仅限非中国大陆居民）
- 退款：微信充值在 24 小时内未使用可退款（不含服务费）；加密货币充值不可退款
- 文档：https://houjiayan.com/docs/
- 运营商：内蒙古火种智能科技有限公司；[email protected]

未来计划

路由层级目前是静态的 + 任务特征评分。我们计划将历史成功率、延迟和用户反馈纳入动态通道权重。支持更多模型和支付方式。欢迎与任何运行多上游大模型网关的人交流笔记。

---

Enter fullscreen mode Exit fullscreen mode