FreeLLMAPI仪表盘详解:Keys、Models、Playground、Analytics四大核心页面手把手教你用
【免费下载链接】freellmapi7.4 billion tokens per month. 34 free LLM providers. 635 free model endpoints. All behind one /v1 endpoint, plus any custom OpenAI-compatible endpoint. Smart routing, automatic failover, encrypted keys. Personal experimentation only.项目地址: https://gitcode.com/GitHub_Trending/fr/freellmapi
FreeLLMAPI 是一款免费的 LLM API 聚合网关,把 34 家免费提供商、635 个模型端点聚合在一个/v1接口后面,并提供智能路由、自动故障切换和密钥加密存储。它的管理仪表盘(Dashboard)是新手上手的第一站——这篇文章带你逐个拆解Keys、Models、Playground、Analytics四大核心页面,看完即可独立完成配置、调试验证和用量监控。
1️⃣ Keys 页面:密钥管理,一切从这里开始
Keys 页面是 FreeLLMAPI 仪表盘的功能中枢,负责管理各家提供商的 API 密钥(Provider Keys),并生成一个供所有客户端使用的统一密钥(Unified Key)。
Keys 页面内部分为 5 个标签页(见 client/src/pages/KeysPage.tsx):
| 标签页 | 作用 |
|---|---|
| Providers(提供商) | 添加/删除 Google、Groq、Mistral 等密钥,查看每把密钥的健康状态圆点和最近一次体检时间 |
| Quota Signals(配额信号) | 查看路由器从上游"学习"到的配额上限信号 |
| API Key(统一密钥) | 复制你的freellmapi-…统一密钥,并管理客户端配置、代理设置、数据库备份 |
| Anthropic | 为 Claude 系客户端单独配置接入 |
| Agents(智能体) | 针对 Claude Code、Cline 等编码智能体做兼容性配置 |
新手三步走:
- 在Providers标签点击Add key,把免费账户密钥逐个粘贴进去(支持批量导入);
- 点击Check all批量体检,确认密钥可用(状态灯变绿);
- 切到API Key标签,复制页面顶部的统一密钥——你之后的所有应用只需要这一把钥匙。
💡 密钥在本地 SQLite 中经 AES-256-GCM 加密存储,只在请求时于内存中解密,源码见
server/src/lib/crypto.ts。
2️⃣ Models 页面:模型路由与月度 Token 预算
Models 页面展示的是"此刻请求会如何路由"的实时视图。
核心看点有三个:
- 月度 Token 预算条:整条提供商舰队的免费额度以堆叠条呈现,剩余量一目了然,下方图例按"提供商资源池"分组(源码:client/src/components/token-usage-bar.tsx);
- 路由策略(Routing Strategy):支持 6 种——手动优先级、均衡、最强(smartest)、最快(fastest)、最可靠(reliable)、自定义权重。表格里的排序就是当前真实的路由顺序;
- Fallback Chain(回退链)管理:拖拽行即可调整优先级,同一模型的多个提供商端点会自动合并为一组、组内严格回退(页面组件:client/src/pages/FallbackPage.tsx)。
实用技巧:点击任意模型进入详情页,可以看到该模型由哪些提供商提供、各自的速率限制和启用开关;需要时可以把某个提供商"拆分"出来独立控制(client/src/pages/ModelDetailPage.tsx)。
3️⃣ Playground 页面:不发代码,直接试聊
Playground 是仪表盘的"试验场":一条聊天消息完整走一遍路由器,你可以直接在消息气泡上看到实际由哪个提供商/模型应答、模型 ID 和延迟——这是排查"为什么走错模型"最快的方式。
它的能力比想象中完整:
- 多会话管理:左侧栏保存历史对话,支持自动标题(client/src/pages/PlaygroundPage.tsx);
- 文件附件:图片(PNG/JPEG/WebP/GIF)在浏览器端压缩后发给视觉模型;文本文件(TXT/MD/CSV/JSON)自动内联进提示词;
- 采样参数调节:右侧设置栏可调整温度等参数;
- Fusion 多模型合成:请求虚拟
fusion模型时,提示词会并行分发给一组模型,再由评审模型综合出最终答案,且可展开追踪面板查看每个草稿。
建议:改完 Keys 或路由顺序后,先来 Playground 发一条消息验证,再去接真实客户端。
4️⃣ Analytics 页面:用量分析,看懂你的免费额度
Analytics 页面回答一个问题:"我的免费额度都花在哪儿了?"
页面提供 24h / 7d / 30d / 90d 四个时间窗口(选择会被记住),核心指标包括(源码:client/src/pages/AnalyticsPage.tsx):
- 总请求数与成功率,以及 p50 / p95 延迟和平均 TTFT(首字节时间);
- Token 消耗:输入/输出分开统计;
- 提供商维度拆解:每家提供商的请求量、错误数、平均延迟、Token/秒吞吐,还能按提供商过滤;
- 客户端维度拆解:识别是谁(哪个 SDK / CLI)在消耗你的额度。
Analytics 菜单下还藏着Logs页面,可查看单条请求日志与每次尝试的路由轨迹,适合定位"某次请求为什么失败"。
上手路线总结
| 顺序 | 页面 | 一句话目标 |
|---|---|---|
| 1 | Keys | 添密钥、体检、拿到统一密钥 |
| 2 | Models | 选路由策略、排回退链、盯预算条 |
| 3 | Playground | 发消息验证路由是否符合预期 |
| 4 | Analytics | 长期观察用量与延迟 |
想深入原理,可阅读 docs/architecture.md 和 docs/api.md。需要本地跑起来时,执行git clone https://gitcode.com/GitHub_Trending/fr/freellmapi即可开始。祝玩得开心 🚀
【免费下载链接】freellmapi7.4 billion tokens per month. 34 free LLM providers. 635 free model endpoints. All behind one /v1 endpoint, plus any custom OpenAI-compatible endpoint. Smart routing, automatic failover, encrypted keys. Personal experimentation only.项目地址: https://gitcode.com/GitHub_Trending/fr/freellmapi
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考