플랫폼
요청 한도(Rate Limit)
요청 한도는 계정이 분당 보낼 수 있는 요청 수의 상한이에요. 공유 처리 용량을 보호하며, 같은 호출이라도 한꺼번에 병렬로 보내면 실패하고 시간차를 두고 보내면 성공하는 이유가 바로 이것이에요.
잘 만든 클라이언트는 한도를 오류가 아니라 계약의 일부로 다뤄요. 즉시 재시도해서 대기열을 더 막히게 하는 대신, 얼마나 기다려야 하는지 알려 주는 응답 헤더를 읽고 물러나요.
한도는 보통 플랜에 따라 늘어날 뿐, 플랜으로 없어지지는 않아요.
eroq에서는
키당 분당 채팅 응답 60회, 이미지 20회, 동영상 또는 음성 렌더 6회이고, Creator 이상부터는 플랜에 따라 배수가 적용돼요(Creator 2×, Studio 4×, Team 6×, Agency 8×). Hobby는 크레딧과 클립 길이는 늘려 주지만 이 상한은 그대로예요. 한도를 넘으면 `rate_limit_exceeded`와 초 단위의 `Retry-After` 헤더가 담긴 429 응답을 받고, 비용은 청구되지 않아요. 관리자는 개별 멤버가 워크스페이스 한도 중 일정 비율만 쓰도록 제한할 수도 있어요.
자주 묻는 질문
한도에 도달하면 어떻게 되나요?
요청이 `rate_limit_exceeded` 코드와 기다려야 할 초를 알려 주는 `Retry-After` 헤더가 담긴 429를 반환해요. 비용은 청구되지 않으니, 짐작으로 재시도하지 말고 헤더에 맞춰 기다리세요.
유료 플랜을 쓰면 한도가 없어지나요?
없애는 게 아니라 늘려 줘요. 그것도 Creator 이상부터만요. Creator는 2×, Agency는 최대 8×예요. Hobby의 분당 상한은 무료 티어와 같고, 무제한 요금제는 없어요.
팀원 한 명이 한도를 전부 써 버릴 수도 있나요?
관리자가 배분을 정해 두지 않으면 그럴 수 있어요. 멤버마다 워크스페이스 한도의 일정 비율로 제한할 수 있고, 이와 별도로 월간 크레딧 상한도 정할 수 있어요.