项目简介
New API 是使用 Go 开发的自托管 AI 网关，即部署在自己环境中、连接应用与上游模型服务的中间层。它提供网页管理控制台，可集中管理模型接入、请求分配、用户权限、使用记录和费用。
项目支持 OpenAI、Anthropic、Google Gemini、Azure OpenAI、AWS Bedrock、Vertex AI、DeepSeek、Qwen 等上游服务。具体功能取决于所选渠道、上游模型及接口转换方式，部分专有工具和字段可能无法完全对应。
项目采用 AGPL-3.0 许可证，README 另列有署名与原项目链接保留要求，使用或修改前应查阅原始仓库的 LICENSE 和 NOTICE。本页面仅收录仓库链接，未验证可运行包或核心业务流程。
项目使用场景
适合团队集中分配已获授权的模型访问权限，为应用或智能体提供统一接口，或者通过网页控制台运营私有的多模型服务。需要切换模型服务商、按用户分配额度、检查调用记录或核算模型成本时，可以考虑使用。
对于财务或法律辅助应用，它可作为底层模型接入与用量管理组件；资料未提供专门的财务分析、法律咨询或业务准确性验证能力。
项目作用与解决的问题
它将多个上游模型服务接入同一管理入口，减少切换服务商时逐个调整客户端配置的工作。模型映射、渠道优先级、权重和重试设置用于管理请求如何发送到上游。
用户、分组、细粒度权限及 API 密钥限制用于控制访问范围；额度、订阅、使用日志和定价配置用于追踪用量并核算成本。网页控制台还提供渠道配置、审计日志查看和模型试用入口。
使用者需要自行取得合法有效的上游账号、API 密钥和接口权限，并遵守相应服务条款。网关不会替代这些授权。
项目使用方法
1. 完成安装并启动服务后，从原始仓库的快速开始说明获取控制台访问地址，打开设置向导并创建管理员账号。所给资料中的页面地址已被遮盖。
2. 在控制台添加渠道，填写自己的上游 API 密钥，设置可用模型与所属分组，然后运行渠道测试。渠道就是连接某个上游模型服务的配置。
3. 配置模型价格，并确认使用者有可用额度或有效订阅。
4. 在控制台创建 New API 签发的 API 密钥，使其能够访问相同分组和模型。
5. 在应用或客户端中填写网关的接口基础地址，并使用 New API 签发的密钥。OpenAI 兼容客户端的具体地址格式请查阅原始仓库；所给资料中的该地址存在格式异常。
6. 选择已启用且支持目标接口的模型发起请求，并在控制台查看使用记录与成本。资料中的请求示例含被遮盖的鉴权内容，不应直接复制运行，应先查阅原始仓库的完整示例。
项目安装方法
1. 准备能够运行 Docker Compose 的环境。README 提供了容器部署方法，列出的容器平台为 Linux amd64 和 arm64；未提供 Docker 本身的安装步骤，请先查阅相应工具的安装资料。
2. 从页面下方原始仓库获取对应克隆地址，将仓库克隆到本地，然后在命令行进入项目目录：`cd new-api`。
3. 打开 `docker-compose.yml`。默认配置会启动 New API、PostgreSQL 和 Redis。替换数据库及 Redis 的示例密码，并同步修改连接字符串中的对应密码。
4. 设置固定保存的随机 `SESSION_SECRET`，它用于身份验证。README 提供的生成命令为 `openssl rand -hex 32`；生成结果应妥善保存，不要公开。
5. 如果控制台使用 HTTPS，设置 `SESSION_COOKIE_SECURE=true`，并按原始仓库说明配置 `SESSION_COOKIE_TRUSTED_URL`。通过 Compose 的 `environment` 或 `env_file` 传入容器变量；仅复制 `.env.example` 不会自动将变量传入容器。
6. 在项目目录执行 `docker compose up -d` 启动服务，再执行 `docker compose logs -f new-api` 查看运行日志。随后按使用方法中的步骤完成初始化。
7. 正式使用前持久化并备份数据库与挂载数据，按 README 配置 HTTPS 以及流式响应和 WebSocket 所需的反向代理。部署时应从原始仓库 Releases 选择固定镜像版本，阅读对应升级说明；`latest` 会随发布变化。本页面未实际验证安装结果。
