要点

⚠️ Breaking Change / 注意：实验性插件系统自 rc.27 引入后仍处于测试阶段，涉及较大架构调整。从 v1.0.0-rc.26 或更早版本升级的用户必须重新配置所有视频模型价格；已完成配置的用户无需重复操作。本版本仍不建议用于生产环境。

新增功能：跨协议转换增强：扩展了 OpenAI Chat Completions、OpenAI Responses、Claude Messages、Gemini 之间的 request、response 和 streaming 转换；现在能更完整地保留 hosted tools、citations、grounding metadata、reasoning intent 和权威 usage 信息（#7137、#7170）。

新增功能：Anthropic count_tokens 接口：新增兼容 Anthropic 的 POST /v1/messages/count_tokens 端点，同时允许 Claude channel 通过协议转换为 Gemini 格式客户端提供服务。

新增功能：RelayKit v0.2.0：发布 RelayKit v0.2.0，带来转换诊断能力和可配置的 tool-loss 策略。

新增功能：MiniMax-H3（Hailuo-03）视频生成：Hailuo 任务插件新增 MiniMax-H3 /v2 视频生成，支持多模态图片/视频/音频引用、768P/2K 输出，以及已验证的 4–15 秒视频时长（#7168、#7171）。

计费字段变更：为 MiniMax-H3 新增 input_images 和 input_video_seconds usage facts。已有 ModelBillingExpr 不会被自动迁移，需要手动引用这些字段才会计算输入媒体费用。

可靠性提升：异步任务轮询加固：增加按上游 host 分类的 HTTP 错误处理；上游返回 404/410 时立即失败并退款；瞬时错误、认证错误、hook 错误和无法识别的响应则使用有上限的连续失败计数器。

新增配置项 TASK_POLL_MAX_FAILURES：默认值为 20，轮询成功会重置计数器，达到上限则任务失败并退款；设为 0 或更低可禁用该限制。原有 TASK_TIMEOUT_MINUTES 超时机制保持兼容。

减少无效匿名请求：优化了匿名冷启动认证逻辑，并为 public notice、home、about、legal-content 等 API 增加 ETag/304 缓存再验证（#7166）。

Bug 修复：修复未变更的系统任务状态写入被误判为 task-lock 丢失的问题（#7135）。

计费与日志隐私修复：在转换和流式请求中保留上游权威 usage，修复 Claude cache 计费、Gemini modality usage、tool-call 附加费用以及中断流结算问题；同时将 user、admin、root、audit 元数据分离，并在用户可见的日志中剥离敏感 channel 和拒绝详情，增强隐私保护。

文档修正：修复多语言文档中的 Video API 链接（#7116）。

QuantumNous/new-api 项目介绍

该项目是一个统一的大模型网关与 AI 资产管理平台，由 QuantumNous 维护，基于开源项目 One API 二次开发，核心定位是将多种大模型服务聚合到一个入口，并以统一/可转换的 API 格式对外提供，同时承担用量统计、成本核算、权限管理等企业级功能。

这个项目是做什么的

提供统一的 AI 模型接入网关，实现多模型聚合与分发。它支持将各种主流 LLM 的请求转换为 OpenAI、Claude、Gemini 等兼容格式，让客户端可以用一套 API 访问不同厂商的模型。
面向个人和企业提供集中的模型管理能力，包括令牌（Token）分组、模型限制、用户管理、用量统计、成本核算、充值额度分配等。
可用于合法授权场景下的 API 网关、组织内部鉴权、多模型管理、用量统计、成本核算和私有化部署。

解决什么问题

解决多家 AI 模型 API 格式不统一、管理分散的问题，通过一个网关屏蔽底层差异。
解决企业内部多模型使用的鉴权、配额、计费、审计问题。
解决原版 One API 功能不足的问题，提供更现代 UI、更多模型格式支持、更细粒度的计费策略。

核心技术架构与实现思路

基于 Go 语言开发，兼容原版 One API 的数据库结构，可平滑迁移。
支持 SQLite 作为默认本地数据库，也支持 MySQL ≥ 5.7.8 和 PostgreSQL ≥ 9.6，并可通过环境变量切换。
支持 Redis 作为分布式缓存和多机部署的必要组件（需设置 REDIS_CONN_STRING）。
以 Docker / Docker Compose 为主要部署方式，也支持宝塔面板一键安装，仅支持 64 位系统（amd64 / arm64）。
内置智能路由：渠道加权随机、失败自动重试、用户级别模型限流。

值得关注的技术亮点

多格式转换能力：
- OpenAI Compatible ⇄ Claude Messages
- OpenAI Compatible → Google Gemini
- Google Gemini → OpenAI Compatible（仅文本，暂不支持函数调用）
- OpenAI Compatible ⇄ OpenAI Responses（开发中）
- 支持“思考转内容”功能
API 格式覆盖广：支持 OpenAI Chat/Responses/Realtime（含 Azure）、Claude Messages、Google Gemini、Rerank（Cohere、Jina）、Midjourney-Proxy、Suno-API、Dify 等。
Reasoning Effort 支持：可通过模型名后缀控制推理强度，如 o3-mini-high、gpt-5-low、claude-3-7-sonnet-20250219-thinking、gemini-2.5-pro-thinking 等。
完整的环境变量配置体系：包括 SESSION_SECRET（多机必需）、CRYPTO_SECRET（Redis 必需）、SQL_DSN、STREAMING_TIMEOUT、MAX_REQUEST_BODY_MB（防 zip bomb）等。
授权与安全：支持 Discord、LinuxDO、Telegram、OIDC 认证登录，并可通过配套工具 new-api-key-tool 查询 Key 额度。
成本管理细致：支持 OpenAI、Azure、DeepSeek、Claude、Qwen 等模型的缓存计费统计，支持按次、按量或缓存命中成本核算。
开源协议与上游关系：项目基于 One API（MIT 许可证）二次开发，本项目采用 AGPLv3 许可证。

快速部署示例（Docker）

# 使用 SQLite
docker run --name new-api -d --restart always \
  -p 3000:3000 \
  -e TZ=Asia/Shanghai \
  -v ./data:/data \
  calciumion/new-api:latest

# 使用 MySQL
docker run --name new-api -d --restart always \
  -p 3000:3000 \
  -e SQL_DSN="root:123456@tcp(localhost:3306)/oneapi" \
  -e TZ=Asia/Shanghai \
  -v ./data:/data \
  calciumion/new-api:latest

部署完成后访问 http://localhost:3000 即可使用。

QuantumNous/new-api v1.0.0-rc.31