AIPDD-new-api

📝 项目说明

[!IMPORTANT]

• 本项目仅面向合法授权的 AI API 网关、组织内部鉴权、多模型管理、用量统计、成本核算和私有化部署场景。
• 使用者必须合法取得上游 API Key、账号、模型服务或接口权限，并遵守上游服务条款及适用法律法规。
• 使用者应确保其使用方式符合上游服务条款及适用法律法规。
• 面向公众提供生成式人工智能服务时，使用者应遵守《生成式人工智能服务管理暂行办法》等监管要求，自行完成所在司法辖区要求的备案、许可、内容安全、实名、日志留存、税务和上游授权等合规义务。

🙏 特别鸣谢

New API 作为本项目的核心底座

🚀 安装说明

• 代码完全开源，直接安装即可
• 商业版增加了Seedance等模型，私有化部署费用为每个客户 ¥1980.00，请加以下二维码进行安装预约即可

🚀 快速开始

[!TIP] 最新版 ACR 镜像： crpi-3iiuxr617jsmyl60.cn-hangzhou.personal.cr.aliyuncs.com/aipdd/ap-new-api-community:latest PostgreSQL 镜像： crpi-3iiuxr617jsmyl60.cn-hangzhou.personal.cr.aliyuncs.com/aipdd/postgres:15 Redis 镜像： crpi-3iiuxr617jsmyl60.cn-hangzhou.personal.cr.aliyuncs.com/aipdd/redis:latest ACR 拉取： docker pull crpi-3iiuxr617jsmyl60.cn-hangzhou.personal.cr.aliyuncs.com/aipdd/ap-new-api-community:latest

部署准备

必配参数

AIPDD 模型调用参数与请求示例请参考 公开 OpenAPI 契约。默认定价由目录同步按「批发价 × 毛利倍率」写入；若某个模型要以人工价为准，在「系统设置 → 定价」里点该模型的钉价按钮（存为 AIPDDPinnedModels），后续同步会跳过它。

使用 Docker Compose（推荐）

# 克隆项目
git clone https://github.com/liujh0729-jpg/aipdd-new-api.git
cd new-api

# 编辑 docker-compose.yml 配置
nano docker-compose.yml

# 登录 ACR 并启动服务
docker login crpi-3iiuxr617jsmyl60.cn-hangzhou.personal.cr.aliyuncs.com
docker compose pull
docker compose up -d

# 登录并拉取最新 AIPDD 镜像
docker login crpi-3iiuxr617jsmyl60.cn-hangzhou.personal.cr.aliyuncs.com
docker pull crpi-3iiuxr617jsmyl60.cn-hangzhou.personal.cr.aliyuncs.com/aipdd/ap-new-api-community:latest

# 使用 AIPDD 镜像并自动配置 AIPDD 渠道
# AIPDD_API_KEY 请先到 https://app.aipdd.work 注册获取
docker run --name new-api -d --restart always \
  -p 6070:6070 \
  -e TZ=Asia/Shanghai \
  -e AIPDD_API_KEY="your-aipdd-api-key" \
  -v ./data:/data \
  crpi-3iiuxr617jsmyl60.cn-hangzhou.personal.cr.aliyuncs.com/aipdd/ap-new-api-community:latest

# 使用 SQLite（默认）
docker run --name new-api -d --restart always \
  -p 6070:6070 \
  -e TZ=Asia/Shanghai \
  -v ./data:/data \
  crpi-3iiuxr617jsmyl60.cn-hangzhou.personal.cr.aliyuncs.com/aipdd/ap-new-api-community:latest

# 使用 MySQL
docker run --name new-api -d --restart always \
  -p 6070:6070 \
  -e SQL_DSN="root:123456@tcp(localhost:3306)/oneapi" \
  -e TZ=Asia/Shanghai \
  -v ./data:/data \
  crpi-3iiuxr617jsmyl60.cn-hangzhou.personal.cr.aliyuncs.com/aipdd/ap-new-api-community:latest

🎉 部署完成后，访问 http://localhost:6070 即可使用！

[!WARNING] 将本项目作为面向公众的生成式 AI 服务或 API 转售服务运营时，使用者应先完成备案、内容安全、实名、日志留存、税务、支付和上游授权等合规义务。

📖 更多部署方式请参考 部署指南

📚 文档

快速导航：

✨ 主要特性

详细特性请参考 特性说明

🎨 核心功能

💰 授权用量与成本管理

• ✅ 合法授权场景下的内部充值与额度分配（易支付、Stripe）
• ✅ 组织内按次、按量或缓存命中成本核算
• ✅ 支持 OpenAI、Azure、DeepSeek、Claude、Qwen 等模型的缓存计费统计
• ✅ 面向内部管理或企业客户的灵活计费策略配置

🔐 授权与安全

• 😈 Discord 授权登录
• 🤖 LinuxDO 授权登录
• 📱 Telegram 授权登录
• 🔑 OIDC 统一认证
• 🔍 Key 查询使用额度（配合 new-api-key-tool）

🚀 高级功能

API 格式支持：

• ⚡ OpenAI Responses
• ⚡ OpenAI Realtime API（含 Azure）
• ⚡ Claude Messages
• ⚡ Google Gemini
• 🔄 Rerank 模型（Cohere、Jina）

智能路由：

• ⚖️ 渠道加权随机
• 🔄 失败自动重试
• 🚦 用户级别模型限流

格式转换：

• 🔄 OpenAI Compatible ⇄ Claude Messages
• 🔄 OpenAI Compatible → Google Gemini
• 🔄 Google Gemini → OpenAI Compatible - 仅支持文本，暂不支持函数调用
• 🚧 OpenAI Compatible ⇄ OpenAI Responses - 开发中
• 🔄 思考转内容功能

Reasoning Effort 支持：

🤖 模型支持

详情请参考 接口文档 - 网关接口

📡 支持的接口

🚢 部署

部署要求、必配参数和 Docker / Docker Compose 命令已合并到上方 快速开始。更多平台部署方式请参考 部署指南。

🔗 相关项目

上游项目

配套工具

💬 帮助支持

📖 文档资源

🤝 贡献指南

欢迎各种形式的贡献！

• 🐛 报告 Bug
• 💡 提出新功能
• 📝 改进文档
• 🔧 提交代码

📜 许可证

本项目采用 GNU Affero 通用公共许可证 v3.0 (AGPLv3) 授权。

本项目基于开源项目 New‑API 二次开发， 原项目采用 GNU Affero General Public License v3.0 (AGPL‑3.0) 许可证。 因此本项目整体继承 AGPL‑3.0 开源协议。

⚠️ 重要说明： 本项目修改后若对外提供网络服务（API/网页等 SaaS 形式）， 必须向用户公开完整修改后的源代码，禁止闭源商用，如需闭源使用请联系原项目获取商业授权。

如果您所在的组织政策不允许使用 AGPLv3 许可的软件，或您希望规避 AGPLv3 的开源义务，请发送邮件至：support@quantumnous.com

🌟 Star History