一个功能丰富的 AI API 连通性测试工具，支持 OpenAI、Anthropic、Gemini、DeepSeek 等多种平台的 API 测试，包含多模型批量测试、自定义壁纸、多线路对比等高级功能。
- 🚀 多平台支持 - 支持 OpenAI、Anthropic、Gemini、DeepSeek 等 API
- ⚡ 实时测试 - 一键测试 API 连通性，显示详细状态码和响应时间
- 🔄 自动测试 - 支持定时自动检测（30s/1m/2m/5m 可选）
- 📊 详细状态 - 区分超时、认证失败、限流、网络错误等多种状态
- ✏️ 快速编辑 - 监控面板直接编辑配置，无需跳转
- 🔀 批量测试 - 支持同一配置多模型并行测试
- 🌐 多线路支持 - 同一 API Key 测试多个转发线路
- 📈 可视化对比 - 延迟条形图、成功率统计
- 📋 详细结果 - 表格展示每个模型的状态码、延迟、错误信息
- 🌓 主题切换 - 支持亮色/暗色主题
- 🖼️ 自定义壁纸 - 支持上传图片或 URL，可调节透明度
- ⚡ 快速配置 - 预设多种 API 模板，一键添加
- 🗃️ 本地存储 - 配置保存到
data/configs.json，支持 Docker 持久化 - 📤 导入导出 - 支持配置的 JSON 格式导入导出
- 🔧 自定义模型 - 独立配置文件
src/config/models.config.js
- 🚀 双架构支持 - Node.js 单体 + Nginx 反向代理两种方案
- 🔒 安全设计 - API Key 本地存储，代理服务器不记录敏感信息
- 前端: Vue 3 + Vite + Tailwind CSS
- 状态管理: Pinia
- 路由: Vue Router
- 后端: Node.js (HTTP 代理服务器)
- 部署: Docker + Docker Compose
- Web服务器: Nginx (可选)
Windows 用户：
# 双击运行或在命令行执行
start.batmacOS/Linux 用户：
# 简单启动
./start.sh
# 或多选项启动
./launch.sh启动脚本功能：
- ✅ 自动检查 Node.js 和 npm 环境
- ✅ 自动安装项目依赖（首次运行）
- ✅ 检查端口占用情况
- ✅ 创建必要的数据目录和配置文件
- ✅ 同时启动前端和后端服务
- ✅ 多种部署模式选择（launch 脚本）
# 使用 docker-compose
docker-compose up -d
# 或者直接构建
docker build -t api-checker .
docker run -d -p 3000:3000 -v $(pwd)/data:/app/data api-checker# 使用 Nginx 反向代理
docker-compose -f docker-compose.nginx.yml up -d
# 手动构建
docker build -f Dockerfile.nginx -t api-checker:nginx .
docker run -d -p 80:80 -v $(pwd)/data:/app/data api-checker:nginx访问：
- Node.js 架构: http://localhost:3000
- Nginx 架构: http://localhost
- Node.js >= 18.0.0
- npm >= 9.0.0
# 克隆项目
git clone https://github.com/xiaopenghuang/API-Checker.git
cd API-Checker
# 安装依赖
npm install
# 同时启动前端和后端（推荐）
npm start
# 或者分别启动
npm run dev # 启动前端开发服务器 (http://localhost:5173)
npm run server # 启动后端代理服务器 (http://localhost:3000)- 快速添加：选择预设模板 → 填写 API Key → 保存
- 手动配置：填写名称、类型、Base URL、API Key、测试模型
- 选择配置：选择一个 API 配置作为测试基础
- 添加线路：为同一服务商添加多个转发 URL
- 选择模型：勾选要测试的模型（支持自定义）
- 开始测试：查看延迟对比和详细结果
- 主题切换：点击顶部太阳/月亮图标
- 自定义壁纸：
- 点击图片图标打开设置
- 上传本地图片或输入 URL
- 调节遮罩透明度
- 编辑：在监控面板点击编辑按钮快速修改
- 导出：配置管理页面导出为 JSON
- 自定义模型：编辑
src/config/models.config.js添加新模型
| 平台 | Base URL 示例 | 备注 |
|---|---|---|
| OpenAI 官方 | https://api.openai.com |
自动补全 /v1 |
| Anthropic | https://api.anthropic.com |
Claude 系列 |
| Google Gemini | https://generativelanguage.googleapis.com/v1beta |
|
| DeepSeek | https://api.deepseek.com |
自动补全 /v1 |
| 转发站点 | https://your-proxy.com |
支持多线路 |
- OpenAI: GPT-4o, o1, o3 系列
- Anthropic: Claude 4.5, Claude 4 系列
- Gemini: 2.0 Flash, 1.5 系列
- DeepSeek: V3, R1 系列
- 其他: Grok, Mistral, Llama, Qwen 等
api-checker/
├── data/ # 数据存储目录
│ ├── configs.json # 配置文件（包含 API Key）
│ └── configs.example.json # 示例配置
├── server/ # 后端代理服务器
│ └── index.js
├── src/
│ ├── components/ # Vue 组件
│ │ ├── ApiCard.vue # API 卡片（支持编辑）
│ │ └── StatsCard.vue # 统计卡片
│ ├── config/ # 配置文件
│ │ └── models.config.js # 模型配置（可自定义）
│ ├── stores/ # Pinia 状态管理
│ │ └── apiStore.js
│ ├── views/ # 页面视图
│ │ ├── HomeView.vue # 监控面板（支持编辑弹窗）
│ │ ├── ConfigView.vue # 配置管理
│ │ └── TestView.vue # 多模型测试
│ ├── App.vue # 主应用（支持自定义壁纸）
│ └── ...
├── nginx.conf # Nginx 配置
├── Dockerfile # Node.js 架构
├── Dockerfile.nginx # Nginx 架构
├── docker-compose.yml # 标准部署
└── docker-compose.nginx.yml # Nginx 部署
| 状态 | 图标 | 说明 |
|---|---|---|
| 正常 | ✓ | API 连接正常，返回 2xx |
| 认证失败 | 🔑 | API Key 无效（401） |
| 限流 | ⚡ | 请求频繁（429） |
| 超时 | ⏱ | 请求超时（30s） |
| 网络错误 | 🌐 | 连接失败 |
| 未找到 | ? | 接口不存在（404） |
| 服务器错误 | 💥 | 服务器内部错误（5xx） |
| 特性 | Node.js 架构 | Nginx 架构 |
|---|---|---|
| 前端服务 | Node.js | Nginx |
| 性能 | 标准 | 优化（静态文件缓存） |
| 端口 | 3000 | 80 |
| 适用场景 | 开发、小型部署 | 生产环境 |
- ✅ API Key 仅存储在本地
data/configs.json - ✅ 后端代理不记录或存储敏感信息
- ✅ 支持 Docker volume 持久化
- ✅
.gitignore已排除配置文件
- Fork 本仓库
- 创建功能分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 打开 Pull Request
本项目采用 MIT 许可证。
🌟 如果这个项目对你有帮助，请给一个 Star！