lengfeng1360 commited on
Commit
c5a4012
·
verified ·
1 Parent(s): b682f96

Upload README.md

Browse files
Files changed (1) hide show
  1. README.md +11 -219
README.md CHANGED
@@ -1,219 +1,11 @@
1
- <p align="right">
2
- <strong>中文</strong> | <a href="./README.en.md">English</a> | <a href="./README.fr.md">Français</a>
3
- </p>
4
- <div align="center">
5
-
6
- ![new-api](/web/public/logo.png)
7
-
8
- # New API
9
-
10
- 🍥新一代大模型网关与AI资产管理系统
11
-
12
- <a href="https://trendshift.io/repositories/8227" target="_blank"><img src="https://trendshift.io/api/badge/repositories/8227" alt="Calcium-Ion%2Fnew-api | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
13
-
14
- <p align="center">
15
- <a href="https://raw.githubusercontent.com/Calcium-Ion/new-api/main/LICENSE">
16
- <img src="https://img.shields.io/github/license/Calcium-Ion/new-api?color=brightgreen" alt="license">
17
- </a>
18
- <a href="https://github.com/Calcium-Ion/new-api/releases/latest">
19
- <img src="https://img.shields.io/github/v/release/Calcium-Ion/new-api?color=brightgreen&include_prereleases" alt="release">
20
- </a>
21
- <a href="https://github.com/users/Calcium-Ion/packages/container/package/new-api">
22
- <img src="https://img.shields.io/badge/docker-ghcr.io-blue" alt="docker">
23
- </a>
24
- <a href="https://hub.docker.com/r/CalciumIon/new-api">
25
- <img src="https://img.shields.io/badge/docker-dockerHub-blue" alt="docker">
26
- </a>
27
- <a href="https://goreportcard.com/report/github.com/Calcium-Ion/new-api">
28
- <img src="https://goreportcard.com/badge/github.com/Calcium-Ion/new-api" alt="GoReportCard">
29
- </a>
30
- </p>
31
- </div>
32
-
33
- ## 📝 项目说明
34
-
35
- > [!NOTE]
36
- > 本项目为开源项目,在[One API](https://github.com/songquanpeng/one-api)的基础上进行二次开发
37
-
38
- > [!IMPORTANT]
39
- > - 本项目仅供个人学习使用,不保证稳定性,且不提供任何技术支持。
40
- > - 使用者必须在遵循 OpenAI 的[使用条款](https://openai.com/policies/terms-of-use)以及**法律法规**的情况下使用,不得用于非法用途。
41
- > - 根据[《生成式人工智能服务管理暂行办法》](http://www.cac.gov.cn/2023-07/13/c_1690898327029107.htm)的要求,请勿对中国地区公众提供一切未经备案的生成式人工智能服务。
42
-
43
- <h2>🤝 我们信任的合作伙伴</h2>
44
- <p id="premium-sponsors">&nbsp;</p>
45
- <p align="center"><strong>排名不分先后</strong></p>
46
- <p align="center">
47
- <a href="https://www.cherry-ai.com/" target=_blank><img
48
- src="./docs/images/cherry-studio.png" alt="Cherry Studio" height="120"
49
- /></a>
50
- <a href="https://bda.pku.edu.cn/" target=_blank><img
51
- src="./docs/images/pku.png" alt="北京大学" height="120"
52
- /></a>
53
- <a href="https://www.compshare.cn/?ytag=GPU_yy_gh_newapi" target=_blank><img
54
- src="./docs/images/ucloud.png" alt="UCloud 优刻得" height="120"
55
- /></a>
56
- <a href="https://www.aliyun.com/" target=_blank><img
57
- src="./docs/images/aliyun.png" alt="阿里云" height="120"
58
- /></a>
59
- <a href="https://io.net/" target=_blank><img
60
- src="./docs/images/io-net.png" alt="IO.NET" height="120"
61
- /></a>
62
- </p>
63
- <p>&nbsp;</p>
64
-
65
- ## 📚 文档
66
-
67
- 详细文档请访问我们的官方Wiki:[https://docs.newapi.pro/](https://docs.newapi.pro/)
68
-
69
- 也可访问AI生成的DeepWiki:
70
- [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/QuantumNous/new-api)
71
-
72
- ## ✨ 主要特性
73
-
74
- New API提供了丰富的功能,详细特性请参考[特性说明](https://docs.newapi.pro/wiki/features-introduction):
75
-
76
- 1. 🎨 全新的UI界面
77
- 2. 🌍 多语言支持
78
- 3. 💰 支持在线充值功能(易支付)
79
- 4. 🔍 支持用key查询使用额度(配合[neko-api-key-tool](https://github.com/Calcium-Ion/neko-api-key-tool))
80
- 5. 🔄 兼容原版One API的数据库
81
- 6. 💵 支持模型按次数收费
82
- 7. ⚖️ 支持渠道加权随机
83
- 8. 📈 数据看板(控制台)
84
- 9. 🔒 令牌分组、模型限制
85
- 10. 🤖 支持更多授权登陆方式(LinuxDO,Telegram、OIDC)
86
- 11. 🔄 支持Rerank模型(Cohere和Jina),[接口文档](https://docs.newapi.pro/api/jinaai-rerank)
87
- 12. ⚡ 支持OpenAI Realtime API(包括Azure渠道),[接口文档](https://docs.newapi.pro/api/openai-realtime)
88
- 13. ⚡ 支持Claude Messages 格式,[接口文档](https://docs.newapi.pro/api/anthropic-chat)
89
- 14. 支持使用路由/chat2link进入聊天界面
90
- 15. 🧠 支持通过模型名称后缀设置 reasoning effort:
91
- 1. OpenAI o系列模型
92
- - 添加后缀 `-high` 设置为 high reasoning effort (例如: `o3-mini-high`)
93
- - 添加后缀 `-medium` 设置为 medium reasoning effort (例如: `o3-mini-medium`)
94
- - 添加后缀 `-low` 设置为 low reasoning effort (例如: `o3-mini-low`)
95
- 2. Claude 思考模型
96
- - 添加后缀 `-thinking` 启用思考模式 (例如: `claude-3-7-sonnet-20250219-thinking`)
97
- 16. 🔄 思考转内容功能
98
- 17. 🔄 针对用户的模型限流功能
99
- 18. 🔄 请求格式转换功能,支持以下三种格式转换:
100
- 1. OpenAI Chat Completions => Claude Messages
101
- 2. Clade Messages => OpenAI Chat Completions (可用于Claude Code调用第三方模型)
102
- 3. OpenAI Chat Completions => Gemini Chat
103
- 19. 💰 缓存计费支持,开启后可以在缓存命中时按照设定的比例计费:
104
- 1. 在 `系统设置-运营设置` 中设置 `提示缓存倍率` 选项
105
- 2. 在渠道中设置 `提示缓存倍率`,范围 0-1,例如设置为 0.5 表示缓存命中时按照 50% 计费
106
- 3. 支持的渠道:
107
- - [x] OpenAI
108
- - [x] Azure
109
- - [x] DeepSeek
110
- - [x] Claude
111
-
112
- ## 模型支持
113
-
114
- 此版本支持多种模型,详情请参考[接口文档-中继接口](https://docs.newapi.pro/api):
115
-
116
- 1. 第三方模型 **gpts** (gpt-4-gizmo-*)
117
- 2. 第三方渠道[Midjourney-Proxy(Plus)](https://github.com/novicezk/midjourney-proxy)接口,[接口文档](https://docs.newapi.pro/api/midjourney-proxy-image)
118
- 3. 第三方渠道[Suno API](https://github.com/Suno-API/Suno-API)接口,[接口文档](https://docs.newapi.pro/api/suno-music)
119
- 4. 自定义渠道,支持填入完整调用地址
120
- 5. Rerank模型([Cohere](https://cohere.ai/)和[Jina](https://jina.ai/)),[接口文档](https://docs.newapi.pro/api/jinaai-rerank)
121
- 6. Claude Messages 格式,[接口文档](https://docs.newapi.pro/api/anthropic-chat)
122
- 7. Dify,当前仅支持chatflow
123
-
124
- ## 环境变量配置
125
-
126
- 详细配置说明请参考[安装指南-环境变量配置](https://docs.newapi.pro/installation/environment-variables):
127
-
128
- - `GENERATE_DEFAULT_TOKEN`:是否为新注册用户生成初始令牌,默认为 `false`
129
- - `STREAMING_TIMEOUT`:流式回复超时时间,默认300秒
130
- - `DIFY_DEBUG`:Dify渠道是否输出工作流和节点信息,默认 `true`
131
- - `FORCE_STREAM_OPTION`:是否覆盖客户端stream_options参数,默认 `true`
132
- - `GET_MEDIA_TOKEN`:是否统计图片token,默认 `true`
133
- - `GET_MEDIA_TOKEN_NOT_STREAM`:非流情况下是否统计图片token,默认 `true`
134
- - `UPDATE_TASK`:是否更新异步任务(Midjourney、Suno),默认 `true`
135
- - `COHERE_SAFETY_SETTING`:Cohere模型安全设置,可选值为 `NONE`, `CONTEXTUAL`, `STRICT`,默认 `NONE`
136
- - `GEMINI_VISION_MAX_IMAGE_NUM`:Gemini模型最大图片数量,默认 `16`
137
- - `MAX_FILE_DOWNLOAD_MB`: 最大文件下载大小,单位MB,默认 `20`
138
- - `CRYPTO_SECRET`:加密密钥,用于加密数据库内容
139
- - `AZURE_DEFAULT_API_VERSION`:Azure渠道默认API版本,默认 `2025-04-01-preview`
140
- - `NOTIFICATION_LIMIT_DURATION_MINUTE`:通知限制持续时间,默认 `10`分钟
141
- - `NOTIFY_LIMIT_COUNT`:用户通知在指定持续时间内的最大数量,默认 `2`
142
- - `ERROR_LOG_ENABLED=true`: 是否记录并显示错误日志,默认`false`
143
-
144
- ## 部署
145
-
146
- 详细部署指南请参考[安装指南-部署方式](https://docs.newapi.pro/installation):
147
-
148
- > [!TIP]
149
- > 最新版Docker镜像:`calciumion/new-api:latest`
150
-
151
- ### 多机部署注意事项
152
- - 必须设置环境变量 `SESSION_SECRET`,否则会导致多机部署时登录状态不一致
153
- - 如果公用Redis,必须设置 `CRYPTO_SECRET`,否则会导致多机部署时Redis内容无法获取
154
-
155
- ### 部署要求
156
- - 本地数据库(默认):SQLite(Docker部署必须挂载`/data`目录)
157
- - 远程数据库:MySQL版本 >= 5.7.8,PgSQL版本 >= 9.6
158
-
159
- ### 部署方式
160
-
161
- #### 使用宝塔面板Docker功能部署
162
- 安装宝塔面板(**9.2.0版本**及以上),在应用商店中找到**New-API**安装即可。
163
- [图文教程](./docs/BT.md)
164
-
165
- #### 使用Docker Compose部署(推荐)
166
- ```shell
167
- # 下载项目
168
- git clone https://github.com/Calcium-Ion/new-api.git
169
- cd new-api
170
- # 按需编辑docker-compose.yml
171
- # 启动
172
- docker-compose up -d
173
- ```
174
-
175
- #### 直接使用Docker镜像
176
- ```shell
177
- # 使用SQLite
178
- docker run --name new-api -d --restart always -p 3000:3000 -e TZ=Asia/Shanghai -v /home/ubuntu/data/new-api:/data calciumion/new-api:latest
179
-
180
- # 使用MySQL
181
- 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 /home/ubuntu/data/new-api:/data calciumion/new-api:latest
182
- ```
183
-
184
- ## 渠道重试与缓存
185
- 渠道重试功能已经实现,可以在`设置->运营设置->通用设置`设置重试次数,**建议开启缓存**功能。
186
-
187
- ### 缓存设置方法
188
- 1. `REDIS_CONN_STRING`:设置Redis作为缓存
189
- 2. `MEMORY_CACHE_ENABLED`:启用内存缓存(设置了Redis则无需手动设置)
190
-
191
- ## 接口文档
192
-
193
- 详细接口文档请参考[接口文档](https://docs.newapi.pro/api):
194
-
195
- - [聊天接口(Chat)](https://docs.newapi.pro/api/openai-chat)
196
- - [图像接口(Image)](https://docs.newapi.pro/api/openai-image)
197
- - [重排序接口(Rerank)](https://docs.newapi.pro/api/jinaai-rerank)
198
- - [实时对话接口(Realtime)](https://docs.newapi.pro/api/openai-realtime)
199
- - [Claude聊天接口(messages)](https://docs.newapi.pro/api/anthropic-chat)
200
-
201
- ## 相关项目
202
- - [One API](https://github.com/songquanpeng/one-api):原版项目
203
- - [Midjourney-Proxy](https://github.com/novicezk/midjourney-proxy):Midjourney接口支持
204
- - [chatnio](https://github.com/Deeptrain-Community/chatnio):下一代AI一站式B/C端解决方案
205
- - [neko-api-key-tool](https://github.com/Calcium-Ion/neko-api-key-tool):用key查询使用额度
206
-
207
- 其他基于New API的项目:
208
- - [new-api-horizon](https://github.com/Calcium-Ion/new-api-horizon):New API高性能优化版
209
-
210
- ## 帮助支持
211
-
212
- 如有问题,请参考[帮助支持](https://docs.newapi.pro/support):
213
- - [社区交流](https://docs.newapi.pro/support/community-interaction)
214
- - [反馈问题](https://docs.newapi.pro/support/feedback-issues)
215
- - [常见问题](https://docs.newapi.pro/support/faq)
216
-
217
- ## 🌟 Star History
218
-
219
- [![Star History Chart](https://api.star-history.com/svg?repos=Calcium-Ion/new-api&type=Date)](https://star-history.com/#Calcium-Ion/new-api&Date)
 
1
+ ---
2
+ title: Api
3
+ emoji: 🚀
4
+ colorFrom: indigo
5
+ colorTo: blue
6
+ sdk: docker
7
+ pinned: false
8
+ license: apache-2.0
9
+ ---
10
+
11
+ Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference