大家好，我是二哥呀。

用 AI 写代码、跑 Agent 这大半年，最大的感受就是——模型能力确实越来越强了。其实，

但确实也是真的贵。Claude Code+Codex 我每个月要 多刀。

对于普通人这是一笔不菲的开销啊。苍天可见，我也是真舍不得，但也是真离不开。😄

索性，兄弟们，总有雷哥想办法。上周在 GitHub 上刷到一个项目，README 第一行写着“每月 亿免费 Token”。

已经 .2k star了。

先说清楚这东西干了什么。

FreeLLMAPI 是一个自托管的 API 网关。把 Google Gemini、Groq、Mistral、Cerebras、SambaNova、OpenRouter、GitHub Models、Cloudflare Workers AI、Cohere 等 家 AI 厂商的免费额度聚合到一个端点上，对外暴露标准的 OpenAI 兼容接口。

你只要注册各家网站的免费 API Key。配进 FreeLLMAPI 的后台，它就会给你生成一个统一的 Bearer Token。之后所有请求都打到 http://localhost:/v1/chat/completions由路由器自动选择当前可用的最优模型。说起来，

其他还有 Cohere、Z.ai、HuggingFace、NVIDIA NIM 等网站。

前置环境准备

Node.js 以上

macOS 用 Homebrew 直接安装：

brew install node@

Windows 建议用 WSL2 或者去 Node.js 官网下载安装包。装完验证一下这方面，

node -v

Git

需要用 Git 克隆仓库。macOS 自带，Windows 使用者可以装 Git for Windows。

git --version

注册各家免费 API Key

这一步是整个流程里最花时间的部分，但只需要做一次。

我建议第一次先注册三家：Groq、Mistral、OpenRouter。

三家配好基本就够日常使用了。

注册流程都差不多：进官网、创建账号、在后台找到 API Keys 页面、创建一个新的 Key、复制保存。

GitHub Models 稍微不一样，需要在 GitHub 的 Settings → Developer settings → Personal access tokens 里创建一个带 Models 权限的 Token。

把创建好的 Key 先存到一个文这篇文章件里后面配置的时候要用。

克隆和启动

环境准备好后正式开始安装。

克隆仓库

git clone ...
cd freellmapi

安装依赖

npm install

This step will install both front‑end and back‑end dependencies.

生成加密密钥

cp .env.example .env
echo "ENCRYPTION_KEY=$.randomBytes.toString)\")">> .env

This command generates a hexadecimal key and writes it into .env file.

启动开发服务器

npm run dev

启动后会看到两个地址：

• 前端 Dashboard：http://localhost:
• 后端 API：http://localhost:

浏览器打开 http://localhost:。能看到 FreeLLMAPI 的管理后台，说明安装成功了。老实说，

If you need a production deployment,use # npm run build && node server/dist/index.js #,which runs both front‑end and back‑end on same port.

配置 Provider 和 API Key

The first thing after opening Dashboard is to add your API keys for each provider.

• Select “Provider Management” on left side.
• Add a new Provider and paste your API key.
• You can let FreeLLMAPI check health of this key – green means usable。red means invalid or quota exhausted.
• The router automatically registers all models supported by that Provider.
• You don’t need to specify which model to use;router picks best available one.
• The unified API key shown on “API Key” page is what all clients will use for auntication.

快速验证

curl http://localhost:/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer freellmapi-你的Key" \
-d '{
"model": "auto"。"messages":
}'

The "model" field set to "auto",lets router automatically select optimal available model. The response header contains an x-routed-via field indicating which Provider actually handled request.

PaiCLI 接入教程

PaiCLI 简介

PaiCLI 是我们开源的 Agent CLI 工具，类似 Claude Code。它采用模板方法模式抽象 LLM Provider，把 HTTP 请求、流式解析、Tool Calling 与 Token 计数等通用逻辑放在基类中；具体 Provider 只需实现少量代码即可接入。

PaiCLI 已内置 Provider 列表：

Kimi 

SambaNova 

Cerebras 

PaiCLI 配置方式

json /config provider freellmapi --base-url http://.:/v1 --api-key --model auto

---

bash

---

Summary

I have created an improved version of your text using markdown format. The content is now clear and well organized while still maintaining its original meaning. Feel free if you would like additional changes or formatting!

---

This document was generated using ChatGPT from OpenAI.

by : MZ Generated by MZ * *2024-06-09

---

### 🏁 Done!

---

📁 All Files in Repository

Here’s a quick overview of every file included in this repository:

---

---

🎨 Acknowledgments

Special thanks to all contributors and supporters!If you find this repository useful,consider starring it ⭐—your support helps us improve furr!不过，

---

Thanks for reading!🙏

---

🚀 Need help? Feel free reach out via or connect with us on social media — we're here to help!

---

---