OpenAI “현재 할당량을 초과했습니다”(insufficient_quota) — 기다려도 해결되지 않는 이유

이는 백오프로 해결할 수 없는 429입니다. insufficient_quota는 계정에 사용할 수 있는 크레딧이 없다는 뜻입니다. 모델이 실행되기 전에 요청이 거부되며 결제가 변경될 때까지 계속 거부됩니다. 현재 결제 상태를 확인하고 몇 분 안에 해결하는 방법은 다음과 같습니다.

오류

response (HTTP 429)

{
  "error": {
    "message": "You exceeded your current quota, please check your plan and billing details. For more information on this error, read the docs: https://platform.openai.com/docs/guides/error-codes/api-errors.",
    "type": "insufficient_quota",
    "param": null,
    "code": "insufficient_quota"
  }
}

원인과 해결 방법 한눈에 보기

원인	해결 방법
선불 크레딧 잔액은 $0	API는 선불 방식입니다. Settings → Billing에서 크레딧을 구매하거나 자동 충전을 활성화하세요. 저장된 카드만으로는 크레딧을 구매하기 전까지 아무것도 추가되지 않습니다.
무료 체험 크레딧이 만료되었거나 모두 사용됨	체험판 제공 크레딧은 사용하지 않았더라도 일반적으로 3개월 후 만료됩니다. 해결 방법은 동일합니다. 결제 수단을 추가하고 크레딧을 구매하세요.
월간 예산 한도에 도달함	Limits에서 직접 설정한 예산에 도달하면 해당 월의 남은 기간 동안 요청이 차단됩니다. 한도를 높이거나 다음 달이 시작될 때까지 기다리세요.
키가 예산이 없는 프로젝트 또는 조직에 속함	sk-proj- 키는 해당 프로젝트의 예산에서 비용을 사용합니다. 프로젝트에는 조직보다 낮은 자체 한도가 있을 수 있습니다. 조직 전체 합계만이 아니라 대시보드에서 키의 프로젝트를 확인하세요.

속도 제한이 아니라 할당량인지 확인하세요

error.type을 읽으세요. rate_limit_exceeded는 1분 이내에 자체적으로 해제되며 백오프가 필요하지만, insufficient_quota는 저절로 해제되지 않으므로 재시도는 아무 의미가 없습니다. 확실하지 않다면 60초 후 한 번 재시도해 보세요. 같은 메시지와 함께 여전히 429가 반환되면 결제 문제입니다.

키가 실제로 사용하는 크레딧 잔액을 확인하세요

platform.openai.com → Settings → Billing에서 크레딧 잔액을 확인하세요. 0 또는 음수라면 크레딧을 구매하세요. 그런 다음 Settings → Limits에서 월간 예산 한도를 확인하고, sk-proj- 키의 경우 소유 프로젝트 자체의 사용 한도도 확인하세요. 세 가지 모두 독립적으로 이 오류를 발생시킬 수 있습니다.

사건이 아니라 재발을 막으세요

합리적인 임계값으로 자동 충전을 활성화하여 바쁜 주말에 프로덕션이 중단되지 않게 하고, 하드 한도뿐 아니라 예산 알림도 설정하여 요청이 실패하기 전에 한도에 가까워지고 있다는 사실을 알림받으세요.

Kunavo를 통해 호출하는 경우

Kunavo도 동일한 선불 모델을 사용하므로, 정직한 비교는 메커니즘이 아니라 지갑의 영향 범위에 관한 것입니다. 하나의 Kunavo 잔액으로 GPT와 Claude를 함께 사용할 수 있고 토큰당 요금이 부과되며 실패한 요청에는 절대 요금이 청구되지 않습니다. Kunavo 자체 지갑이 소진되면 code insufficient_quota와 함께 402가 반환됩니다(OpenAI SDK 오류 처리가 그대로 작동하도록 의도적으로 동일한 코드를 사용합니다). 충전하면 즉시 해결되며, 해제해야 할 월간 한도도 없습니다. 해결 비용을 예산에 반영하시나요? OpenAI의 공식 목록과 함께 현재 토큰당 GPT 요금은 다음에 있습니다: GPT API 가격 목록.

자주 묻는 질문

신용카드를 추가했는데 왜 여전히 insufficient_quota가 발생하나요?

API는 카드에서 직접 결제하는 것이 아니라 선불 크레딧을 사용하기 때문입니다. 카드를 추가하면 구매만 가능해질 뿐이며, 크레딧을 구매하거나 자동 충전을 켜야 합니다. 잔액이 양수가 된 후 1~2분 이내에 오류가 사라집니다.

insufficient_quota가 저절로 해결되기도 하나요?

한 가지 경우에만 가능합니다. 월간 예산 한도는 다음 달이 시작되면 초기화됩니다. 잔액이 0인 경우와 체험판이 만료된 경우에는 크레딧을 구매할 때까지 지속됩니다. 어느 경우든 재시도 루프는 도움이 되지 않습니다. 모델이 실행되기 전에 요청이 거부되기 때문입니다.

실패한 429 요청에도 비용이 드나요?

아니요. OpenAI는 추론 전에 이를 거부하며, Kunavo에서도 실패한 요청에는 요금이 청구되지 않습니다. 비용은 가동 중단이며, 이것이 자동 충전과 예산 알림이 하드 한도만 설정하는 것보다 나은 이유입니다.