OpenAI 무료 토큰(Complimentary Daily Tokens)이 사용되지 않는 이유
(insufficient quota detected.)
1. 배경
OpenAI API에 Data Sharing 옵트인을 하면 매일 무료 토큰을 줍니다.
Tier 3-5 기준으로 대형 모델(gpt-5, gpt-4.1, gpt-4o, o1, o3 등) 1M 토큰,
소형 모델(gpt-5-mini, gpt-4o-mini, o3-mini 등) 10M 토큰. Tier 1-2는 각각 250K, 2.5M입니다.
설정 페이지에 "You're enrolled for complimentary daily tokens"도 잘 떠 있습니다.
근데 API를 호출하면 이게 나옵니다.
Error code: 429 - You exceeded your current quota,
please check your plan and billing details.
분명 무료 토큰 범위 안인데 429가 뜹니다.
2. 원인: 잔고가 0 이하
한참 찾았는데 원인은 단순했습니다. 계정 잔고(Balance)가 양수여야 무료 토큰이 작동합니다.
"무료"라면서 잔고가 있어야 된다는 건 좀 이상하긴 한데, 그렇습니다.
크레딧을 다 써서 잔고가 0 이하로 내려가면, 무료 토큰까지 같이 막힙니다.
커뮤니티에서도 Tier 5인데 -$0.25 잔고 때문에 안 됐다는 사례가 있었습니다.
해결
Billing Overview에서 "Add to balance"로 크레딧을 충전하면 됩니다. 최소 $5.
충전 후 시스템 반영에 몇 분 걸릴 수 있습니다.
3. 그래도 안 되면
잔고를 충전했는데도 안 된다면 확인할 게 몇 가지 더 있습니다.
3-1. Data Sharing 옵트인
Data Controls > Sharing 페이지에 가서, "You're enrolled for complimentary daily tokens" 문구가 보이는지 확인합니다.
안 보이면 옵트인이 안 된 겁니다. 옵트인은 Organization Owner만 할 수 있습니다.
3-2. API 키가 옵트인된 프로젝트의 키인지
Data Sharing을 특정 프로젝트에만 활성화했다면, 해당 프로젝트의 API 키로 호출해야 합니다.
다른 프로젝트 키로 쏘면 무료 토큰이 적용 안 됩니다. "Enable for all projects"로 했으면 상관없습니다.
3-3. 일일 한도 초과
무료 토큰에도 일일 한도가 있고, 매일 00:00 UTC에 초기화됩니다. 한도를 넘긴 요청부터는 정상 요금으로 부과됩니다.
3-4. 미지원 모델
Fine-tuned 모델, Fine-tuning training, Evals, Tool use는 무료 토큰 대상이 아닙니다.
지원 모델 목록은 공식 문서 혹은 옵트인 설정 페이지에서 확인하세요.
4. 카드 등록 시 $5 결제
API 결제 수단을 등록하면 $5가 바로 빠집니다.
실제 결제가 아니라 임시 인증용 홀드(Temporary Authorization Hold)입니다. 7일 이내에 자동 환불됩니다.
참고: OpenAI 공식 안내 - $5 Temporary Hold
5. 참고
'IT 기술' 카테고리의 다른 글
| npm run dev 시 EACCES: Permission Denied 포트 충돌 해결방법 (0) | 2025.07.13 |
|---|---|
| 구글 시트를 활용한 홈페이지 폼 데이터 수집 시스템 구축하기 (0) | 2025.06.21 |
| SEO와 AEO: 변화하는 디지털 마케팅 전략 (0) | 2025.04.05 |
| MVP와 PoC, Prototype, Pilot의 차이 – 개념과 활용법 총정리 (4) | 2025.03.07 |
| 블로그 마크다운 코드블럭 색상 적용 문제 해결 방법 (Markdown Code Highlighting) (1) | 2025.03.05 |