forked from boos/BoosAPI
7bd3114ea0
- Added `inputFiles.ts` for handling input file resolution, including validation and normalization of file types. - Introduced `proxyFileStore.ts` for managing file storage, retrieval, and deletion with owner-based isolation. - Created tests for proxy file storage functionality in `proxyFileStore.test.ts`. - Developed `proxyInputFileResolver.ts` to resolve input files in OpenAI and response formats. - Added utility functions for handling reasoning signatures in `reasoningTransport.ts` and corresponding tests. - Enhanced shared input file transformers in `inputFile.ts` for better file handling and type inference.
📚 Metapi 文档中心
中转站的中转站 — 将分散的 AI 中转站聚合为一个统一网关
文档站运行
npm run docs:dev
构建静态站点:
npm run docs:build
快速导航
| 文档 | 适合谁 | 解决的问题 |
|---|---|---|
| 🚀 快速上手 | 首次使用者 | 10 分钟完成部署与首次请求 |
| 🚢 部署指南 | 部署维护者 | Docker Compose、反向代理、升级回滚 |
| ⚙️ 配置说明 | 管理员 | 全部环境变量、路由参数、通知渠道 |
| 🔌 客户端接入 | 下游应用接入者 | Open WebUI、Cherry Studio、Cursor 等接入 |
| 🔧 运维手册 | 运维人员 | 备份恢复、日志排查、健康检查 |
| ❓ 常见问题 | 所有用户 | 常见报错与修复路径 |
| 🧩 FAQ/教程贡献规范 | 社区贡献者 | 统一沉淀 FAQ、教程与排障经验 |
| 📁 目录规范 | 开发者 | 项目目录组织与约定 |
🏛️ 架构概览
核心概念
- 站点 (Site):一个上游中转站实例(如 New API、OneHub 等)
- 账号 (Account):在某站点上注册的用户账号
- Token:账号下的 API Key,用于访问该站点的 API
- 路由 (Route):一条模型匹配规则,如
claude-sonnet-4-6 - 通道 (Channel):路由下的一条 Token 链路,一个路由可有多个通道
- 代理 (Proxy):Metapi 对下游暴露的统一 API 入口
开源协作
- 📝 贡献流程:CONTRIBUTING.md
- 🛡️ 安全策略:SECURITY.md
- 📜 行为准则:CODE_OF_CONDUCT.md
