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가 뜹니다.

한참 찾았는데 원인은 단순했습니다. 계정 잔고(Balance)가 양수여야 무료 토큰이 작동합니다.

"무료"라면서 잔고가 있어야 된다는 건 좀 이상하긴 한데, 그렇습니다.

크레딧을 다 써서 잔고가 0 이하로 내려가면, 무료 토큰까지 같이 막힙니다.

커뮤니티에서도 Tier 5인데 -$0.25 잔고 때문에 안 됐다는 사례가 있었습니다.

Billing Overview에서 "Add to balance"로 크레딧을 충전하면 됩니다. 최소 $5.

충전 후 시스템 반영에 몇 분 걸릴 수 있습니다.

잔고를 충전했는데도 안 된다면 확인할 게 몇 가지 더 있습니다.

Data Controls > Sharing 페이지에 가서, "You're enrolled for complimentary daily tokens" 문구가 보이는지 확인합니다.

안 보이면 옵트인이 안 된 겁니다. 옵트인은 Organization Owner만 할 수 있습니다.

Data Sharing을 특정 프로젝트에만 활성화했다면, 해당 프로젝트의 API 키로 호출해야 합니다.

다른 프로젝트 키로 쏘면 무료 토큰이 적용 안 됩니다. "Enable for all projects"로 했으면 상관없습니다.

무료 토큰에도 일일 한도가 있고, 매일 00:00 UTC에 초기화됩니다. 한도를 넘긴 요청부터는 정상 요금으로 부과됩니다.

Fine-tuned 모델, Fine-tuning training, Evals, Tool use는 무료 토큰 대상이 아닙니다.

지원 모델 목록은 공식 문서 혹은 옵트인 설정 페이지에서 확인하세요.

API 결제 수단을 등록하면 $5가 바로 빠집니다.

실제 결제가 아니라 임시 인증용 홀드(Temporary Authorization Hold)입니다. 7일 이내에 자동 환불됩니다.