# Show GN: GemBack - Gemini API Fallback Library

> Clean Markdown view of GeekNews topic #24540. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=24540](https://news.hada.io/topic?id=24540)
- GeekNews Markdown: [https://news.hada.io/topic/24540.md](https://news.hada.io/topic/24540.md)
- Type: show
- Author: [laeyoung](https://news.hada.io/@laeyoung)
- Published: 2025-11-22T23:39:41+09:00
- Updated: 2025-11-22T23:39:41+09:00
- Original source: [github.com/Laeyoung](https://github.com/Laeyoung/gem-back)
- Points: 6
- Comments: 0

## Summary

**GemBack**은 여러 **Gemini 모델의 무료 API 쿼터를 자동으로 분산·전환(fallback)** 해주는 경량 **NPM 라이브러리**입니다. 모델별 **RPM 제한** 때문에 매번 수동으로 예외 처리를 하던 개발자에게 특히 유용하며, `gemini-2.5-flash`부터 `2.0-flash-lite`까지 최대 **70 RPM**을 자동으로 활용합니다. 단일 **API 키 설정만으로 안정적인 호출 흐름**을 유지할 수 있어, 실험적 프로젝트나 프로토타이핑 단계에서 생산성을 높여줍니다. 이런 “작지만 실용적인 자동화”가 결국 개발자의 시간을 가장 많이 아껴주는 부분이라는 점이 인상적입니다.

## Topic Body

매번 새로운 걸 만들 때마다, Gemini 무료 API를 유용하게 쓰고 있는데요.  
Model마다 주어진 분당 Quota가 달라서, 매번 똑같은 Gemini API Fallback 로직을 만들고 있더라고요.  
그래서 해당 로직을 가진 NPM Library를 만들어 보았습니다.  
  
- [Github](https://github.com/Laeyoung/gem-back)  
- [NPM](https://www.npmjs.com/package/gemback)  
  
  
##### 메인 기능  
- 4개의 Gemini Model 자동 Fallback 지원  
- gemini-2.5-flash -> gemini-2.5-flash-lite -> gemini-2.0-flash -> gemini-2.0-flash-lite 순서로 호출 (총 70 RPM 사용 가능)  
  
##### [설치](https://www.npmjs.com/package/gemback)  
```bash  
npm install gemback  
```  
  
##### 사용법  
  
```Typescript  
import { GeminiBackClient } from 'gemback';  
  
const client = new GeminiBackClient({  
  apiKey: process.env.GEMINI_API_KEY  
});  
  
const response = await client.generate('안녕하세요, Gemini!');  
console.log(response.text);  
```  
  
  
---  
참고로, Gemini 2.5 Pro는 무료 Quota를 주지만, 2 RPM 밖에 안줘서 제외 했습니다.  
Gemini 3도 Pro 출시 이후에 조만간 다른 Variation 들도 추가 된다고 하니 추가 되면 업데이트 해보도록 하겠습니다.

## Comments



_No public comments on this page._