New API 初始设置指南

New API 是一款开源 AI API 网关，可将多个上游 AI 提供商聚合到单个兼容 OpenAI 的端点之后。它支持多密钥管理、用量追踪、权限控制以及跨渠道的自动故障切换。

本文涵盖部署完成后的初始配置步骤，从管理员账号设置到多密钥负载均衡等核心功能的配置。

部署完成后首次访问管理面板时，会显示设置向导，引导创建管理员账号。设置一个强密码并登录即可进入仪表盘。

渠道代表到上游 AI 提供商的连接。添加渠道的步骤如下：

1. 导航到渠道 → 添加渠道
2. 选择提供商类型（如 Google Gemini、OpenAI、Anthropic 或自定义 OpenAI 兼容端点）
3. 输入该提供商的 API Key
4. 设置权重——权重越高的渠道，接收到的请求比例越大
5. （可选）限制该渠道可访问的模型

对于通过 OpenAI 兼容 API 暴露的服务，选择自定义渠道并设置对应的 base URL 即可。

令牌是下游应用的 API 凭证：

1. 进入令牌 → 添加令牌
2. 设置名称，并可选择设置配额限制
3. 指定该令牌允许访问的模型
4. 复制生成的密钥——关闭后不会再次显示

下游应用使用该令牌作为 api_key，将 New API 地址作为 base_url（末尾追加 /v1）。

New API 的核心功能之一是能将请求分布到同一提供商的不同 API Key 上。当单个账号存在速率限制或额度上限时，这一功能尤为实用。

设置方法：

1. 为每个 API Key 创建一个独立的渠道
2. 设置权重来控制请求分配比例（权重=2 的渠道接收到的请求数是权重=1 的两倍）
3. 设置优先级——优先级高的渠道会被优先尝试
4. 当某个渠道失败时（速率限制、额度耗尽、服务器错误），New API 自动重试下一个可用渠道

这使得多密钥设置对下游客户端完全透明——单个令牌和 base URL 背后可以支撑多个上游密钥，自动完成故障切换。

New API 内置配额核算系统：

1. 每次 API 调用根据模型定价规则折算为配额单位
2. 令牌可设置消费上限
3. 管理员可在后台为用户充值配额
4. 使用日志显示每次请求的详细信息，包括模型、Token 数和费用

1. 首次登录后立即修改默认管理员密码
2. 在设置 → 安全中为管理员账号启用双重认证
3. 为不同的下游应用使用独立的令牌，并设置模型访问限制
4. 定期审查使用日志，留意异常活动

New API 提供了一种简洁的方式，将多个 AI 提供商账号整合到单个兼容 OpenAI 的端点之后。其基于渠道的架构支持负载均衡、故障切换和细粒度访问控制——无论是个人使用还是团队部署都非常适用。