
한 줄 요약: 사용량 숫자는 하나처럼 보이지만 실제로는 잔여량, 갱신 시각, 데이터 출처, 오류 여부가 함께 있어야 해석할 수 있습니다.
기록 성격: 공개 상태 모델 해설. 원본 문서·계정·내부 경로는 공개하지 않습니다.
먼저 확인한 핵심
- 숫자만 보지 말고 마지막 갱신 시각을 확인합니다.
- 0과 값 없음, 오류는 전혀 다른 상태로 표시합니다.
- 다른 서비스의 수치를 합칠 때는 출처와 단위를 분리합니다.

왜 이 기준이 필요한가
한 화면에 여러 값을 모으는 도구일수록 신뢰의 핵심은 화려한 집계가 아니라 상태를 숨기지 않는 표기입니다.

읽고 나서 확인할 것
이 글의 정보는 게시 시점의 공개 범위와 공식 문서에 적힌 기준을 나눠 정리한 것입니다. 제품·서비스의 실제 이용 가능 여부는 공식 안내와 현재 화면을 함께 확인하세요.
공식 문서로 본 한도 표시: 남은 양, 초기화, 재시도
사용량 화면의 숫자가 어디서 오는지 이해하려면 API 쪽 한도 응답이 어떤 값을 주는지부터 보는 것이 좋습니다. 아래는 Anthropic과 OpenAI 공식 개발자 문서(2026년 10월 18일 기준)에 적힌 내용만 옮긴 것입니다.
Anthropic: 한도·남은 양·초기화가 따로 옵니다
Anthropic의 속도 제한 문서는 응답 헤더로 현재 적용된 한도, 남은 양, 한도가 다시 채워지는 시각을 알려 준다고 설명합니다. 요청 수와 토큰 수가 각각 limit, remaining, reset 세 값으로 나뉘고, 입력 토큰과 출력 토큰도 따로 표시됩니다. 초기화 시각은 RFC 3339 형식으로 제공되고, 토큰 잔량은 천 단위로 반올림된 값입니다. 따라서 화면에 보이는 잔량은 정확한 개수가 아니라 근삿값일 수 있습니다.
이 문서는 토큰 버킷 알고리즘을 쓴다고도 밝힙니다. 정해진 시각에 한꺼번에 초기화되는 것이 아니라, 최대치까지 용량이 계속 채워지는 방식입니다. 그래서 “초기화 시각”은 완전히 채워지는 시점을 뜻하고, 그 전에도 일부는 이미 회복되어 있을 수 있습니다. 또 retry-after 헤더는 재시도까지 기다릴 초 단위 시간인데, 모든 429 응답에 붙는 것은 아니며 월 지출 한도에 걸린 429에는 붙지 않는다고 적혀 있습니다.
OpenAI: 초기화가 시각이 아니라 남은 시간입니다
OpenAI의 속도 제한 문서에는 x-ratelimit-limit-requests, x-ratelimit-remaining-tokens처럼 요청·토큰별 헤더가 나옵니다. 예시 값으로 한도 60, 남은 요청 59, 요청 초기화 1s, 토큰 초기화 6m0s가 실려 있습니다. 같은 “초기화”라도 Anthropic은 시각, OpenAI는 남은 시간 형식이라는 뜻입니다. 두 서비스의 값을 한 화면에 합칠 때 단위와 출처를 분리해야 하는 이유가 여기에 있습니다.
Retry-After는 일시적인 속도 제한 오류에서 최소 몇 초를 기다릴지 알려 주는 값이며, 결제나 할당량처럼 사용자의 조치가 필요한 오류는 재시도로 해결되지 않는다고 문서가 밝힙니다. 헤더가 없거나 올바르지 않으면 지수 백오프와 지터를 쓰라는 안내도 있습니다.
| 읽을 값 | Anthropic 문서 | OpenAI 문서 |
|---|---|---|
| 한도 | anthropic-ratelimit-*-limit | x-ratelimit-limit-* |
| 남은 양 | *-remaining (토큰은 천 단위 반올림) | x-ratelimit-remaining-* |
| 초기화 표기 | RFC 3339 시각 | 남은 시간 (예: 1s, 6m0s) |
| 재시도 안내 | retry-after (초, 없을 수 있음) | Retry-After (최소 대기 초, 조치형 오류는 해당 없음) |
시각과 갱신 시점을 읽는 법
MDN 문서에 따르면 HTTP의 Date 헤더는 항상 GMT로 표기되며 현지 시각이 아닙니다. 서버가 준 시각을 화면에 보여 줄 때는 사용자 시간대로 바꿔야 “몇 시에 갱신됐는지”를 오해하지 않습니다. 429 상태 코드는 짧은 시간에 요청이 너무 많았다는 뜻이고, 같은 문서에 따르면 Retry-After가 포함될 수도 있고 아닐 수도 있습니다. 또 MDN의 캐싱 문서는 저장된 응답이 나이(age)에 따라 신선하거나 오래된(stale) 상태로 나뉜다고 설명합니다. 화면의 숫자가 캐시나 저장된 값이라면 얼마나 오래된 값인지 함께 보여 줘야 한다는 이 글의 기준과 같은 방향입니다.
정리하면 “남은 비율”, “초기화 시각”, “마지막 갱신 시각”은 공식 문서에서도 서로 다른 값으로 취급됩니다. 한 칸에 숫자 하나만 보여 주는 화면은 이 중 일부를 감추고 있다고 보는 편이 안전합니다.
업데이트
이 글의 원문 발행 뒤에도 제품 기능·정책·측정 조건은 달라질 수 있습니다. 이 글은 2026년 10월 18일 기준 공식 공개 자료를 바탕으로 하며, 확인 가능한 내용과 그 한계를 설명하는 데 범위를 둡니다. 새 공지에서 제공 범위·제한·수치가 달라졌다면 그 최신 공지가 우선합니다.
확인 자료
- Anthropic 공식 문서: 속도 제한과 응답 헤더
- OpenAI 공식 문서: 속도 제한 가이드
- MDN: 429 Too Many Requests
- MDN: Date 헤더
- MDN: HTTP 캐싱
기준일: 2026-10-18