# 무료 API 크레딧 세팅 가이드

> 상태: 리서치 완료, 적용 미결정
> 작성: 2026-03-16
> 참고 기사: https://www.howtogeek.com/google-and-openai-offer-free-api-creditsbut-theres-one-catch/

---

## 1. OpenAI 무료 API 토큰

### 조건
- **데이터 공유 필수**: 입출력이 모델 학습에 사용됨
- **최소 $5 잔액** 필요 (잔액 없으면 무료 토큰 미적용)

### 일일 무료 토큰 (Tier 1~2 기준)
- **프리미엄 모델** (GPT-5, GPT-5-Codex, o3 등): **250,000 토큰/일**
- **경량 모델** (GPT-5-Mini, GPT-5-Nano 등): **2,500,000 토큰/일**

### Tier 3+ 기준
- 프리미엄: 1,000,000 토큰/일
- 경량: 10,000,000 토큰/일

### 세팅 방법
1. [platform.openai.com](https://platform.openai.com) 로그인
2. Settings → Data controls
3. "Share inputs and outputs with OpenAI" 토글 활성화
4. "Enabled For Selected Projects" 또는 "Enabled For All Projects" 선택
5. 활성화 후 "You're enrolled for complimentary daily tokens" 메시지 확인

### 하이브리드 운용 (핵심)
- **프로젝트별로 데이터 공유 ON/OFF 선택 가능**
- 예: "Project-Dev" (공유 ON = 무료) + "Project-Prod" (공유 OFF = 유료)
- 기존 API 키 그대로 사용 가능 (새 키 불필요)
- 무료 한도 초과 시 자동으로 유료 전환

### 제외 사항
- Fine-tuned 모델, Fine-tuning 학습, Evals, Tool use는 미포함
- 한 요청이 일일 한도 초과 시 전체 요청이 유료 (부분 무료 없음)
- 프로그램 30일 사전 통보 후 종료 가능

---

## 2. Google Gemini API 무료 티어

### 조건
- 데이터 공유 조건 없음
- 신용카드 불필요 (Google 계정만 있으면 됨)

### 무료 Rate Limits
- **Gemini 2.5 Pro**: 5 RPM / 250K TPM / 100 RPD
- **Gemini 2.5 Flash**: 10 RPM / 250K TPM / 250 RPD
- **Gemini 2.5 Flash-Lite**: 15 RPM / 250K TPM / 1,000 RPD

### 세팅 방법
1. [aistudio.google.com](https://aistudio.google.com) 접속
2. "Get API key" 클릭
3. "Create API key in new project" 선택
4. API 키 복사 → 환경변수 저장

### 주의사항
- 여러 키 만들어도 같은 프로젝트면 쿼터 공유 (키 추가로 쿼터 안 늘어남)
- RPD 리셋 시간: 태평양 시간 자정
- 무료에서도 100만 토큰 컨텍스트 윈도우 사용 가능

---

## 3. 우리 시스템 적용 계획

### OpenAI (하이브리드)
- **무료 프로젝트**: 집단지성 봇 일반 토론, 아틀라스 코드 리뷰
- **유료 프로젝트**: 고객 정보 포함 작업, 민감 데이터 분석
- 같은 API 키, 프로젝트만 분리하면 됨

### Google Gemini
- **비너스 세컨드오피니언**: Flash 기준 일 250요청이면 충분
- 현재 OAuth 방식 → API 키 방식 전환 검토 필요

### 적용 대상 컴포넌트
| 컴포넌트 | API | 현재 | 무료 전환 |
|----------|-----|------|-----------|
| 집단지성 봇 (Codex) | OpenAI | 유료 API키 | 무료 프로젝트로 분리 가능 |
| 아틀라스 (미구현) | OpenAI | - | 무료로 시작 가능 |
| embedding_service | OpenAI | 별도 유료 키 | 별도 검토 필요 |
| 비너스 (Gemini) | Google | OAuth | API 키 무료 티어 전환 가능 |
| 3대 엔진 합의도출 | 양쪽 | - | 양쪽 무료 적용 가능 |

### 예상 월 절감액
- 집단지성 mini 기준: 일 250만 토큰 무료 = 약 $15/일 = **$450/월**
- Gemini: 이미 무료 가능 = 추가 절감 없음
- 합계: **월 $300~$450 절감 추정**

---

## 4. 세팅 시 체크리스트 (적용 결정 시)
- [ ] OpenAI platform.openai.com 접속 → 잔액 $5 이상 확인
- [ ] Settings → Data controls → Share 토글 활성화
- [ ] 무료 프로젝트 생성 (집단지성용)
- [ ] 유료 프로젝트 유지 (민감 작업용)
- [ ] 프로젝트별 API 키 발급 또는 기존 키 연결
- [ ] .env.keys에 프로젝트별 키 분리 저장
- [ ] engine.py에서 용도별 API 키 분기 로직 추가
- [ ] Google AI Studio → Gemini API 키 발급
- [ ] 비너스 봇 API 키 방식 전환
- [ ] 테스트 후 비용 모니터링