====== New API 初始设置指南 ======

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

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

===== 初始配置 =====

==== 管理员账号 ====

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

==== 添加渠道 ====

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

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

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

==== 创建令牌 ====

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

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

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

===== 多密钥负载均衡 =====

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

设置方法：

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

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

===== 用量配额与计费 =====

New API 内置配额核算系统：

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

===== 安全建议 =====

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

===== 总结 =====

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


{{tag>NewAPI API网关 负载均衡 配置}}