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 的端点之后。其基于渠道的架构支持负载均衡、故障切换和细粒度访问控制——无论是个人使用还是团队部署都非常适用。