tashfeenahmed/freellmapi는 AI 회사들의 무료 사용량을 모아 OpenAI 호환 주소 하나로 쓰게 해 주는 오픈소스입니다. README는 무료 사용량을 모두 합치면 한 달에 약 74억 토큰이라고 계산합니다. 라이선스는 MIT이고, 2026년 11월 7일 기준 깃허브 스타가 4만 8천 개입니다.
어떻게 동작하나
| 항목 | 내용 |
|---|---|
| 묶는 곳 | Google, Groq, Cerebras, Mistral, OpenRouter, Cloudflare, Cohere, NVIDIA, Hugging Face 등 무료 34곳 |
| 모델 | 474개 계열, 무료 주소 635개 (채팅, 임베딩, 음성 인식 등) |
| 주소 | /v1 하나 (OpenAI 방식, Anthropic Messages 방식, Gemini 방식) |
| 키 | 내 키는 SQLite에 AES-256-GCM으로 암호화, 앱에는 통합 키 하나만 |
| 장애 대응 | 429나 5xx가 나면 다음 모델로 넘어가고, 키마다 분당·하루 한도를 따로 셉니다 |
fusion이라는 가상 모델을 부르면 무료 모델 여러 개에 같은 질문을 보내고, 심사 모델이 답을 하나로 합칩니다.
설치
Docker가 있으면 한 줄로 설치합니다. 파이프로 넘기기 전에 스크립트를 먼저 읽어 보세요.
curl -fsSL https://freellmapi.co/install.sh | bash윈도우는 Releases의 .exe, 맥은 .dmg 메뉴 막대 앱이 더 쉽습니다. 설치 후 http://localhost:3001을 열고 다음 순서로 씁니다.
- 각 회사에서 무료 키를 받아 Keys 화면에 넣습니다.
- Fallback Chain에서 모델 순서를 정합니다.
- Keys 화면 위쪽의 통합 키를 복사합니다.
기존 코드와 에이전트에 붙이기
OpenAI SDK를 쓰는 코드라면 주소와 키만 바꾸면 됩니다.
from openai import OpenAI
client = OpenAI(base_url="http://localhost:3001/v1", api_key="통합 키")Claude Code는 이 명령이 설정을 백업한 뒤 연결해 줍니다. Codex, Gemini CLI, Cursor 등에도 같은 식의 명령이 있습니다.
npx freellmapi setup-claude --url http://localhost:3001 --api-key 통합키꼭 알아야 할 한계
- 최신 최고 모델은 없습니다. 무료로 풀린 모델만 씁니다.
- 하루가 지날수록 답이 약해집니다. 좋은 모델부터 하루 한도가 차고, UTC 자정(한국 시각 오전 9시)에 다시 채워집니다.
- 응답 속도가 들쭉날쭉하고 보장(SLA)이 없습니다.
- README는 개인 실험과 학습용이라고 밝힙니다. 서비스 운영에 쓰지 말라는 뜻입니다.
- 무료 사용량을 이렇게 묶어 쓰는 것을 회사마다 어떻게 보는지는 README가 2026년 5월 기준으로 정리해 둔 약관 검토를 확인하세요. 약관은 바뀝니다.
- 무료 설치판은 새 모델 목록을 한 달에 한 번 받습니다(유료 연 19달러는 하루 두 번).
오늘 할 일
무료 키 두세 개(예: Google AI Studio, Groq, OpenRouter)만 넣고 사이드 프로젝트의 base_url을 바꿔 보세요. 대시보드의 Analytics에서 어느 회사가 답했는지 볼 수 있습니다.
쇼츠로 보기
이 글은 비치콤버스 쇼츠 No.62의 짝 글입니다. 짧은 주소 beachcombers.co.kr/s/62.