호출 한도는 API 키마다 따로 적용됩니다. 같은 워크스페이스라도 키가 다르면 한도도 따로 계산되며, 키 하나의 한도에는 모든 엔드포인트의 호출이 합산됩니다.
항목 | 한도 |
|---|---|
API 키 초당 호출 수 | 5회 |
이어서 받을 수 있는 결과 | 소재 검색·영상 검색·유사 소재 검색은 약 1,000건, 브랜드 탐색은 약 400건까지 |
cursor 유효기간 | 발급 후 24시간 |
워크스페이스당 API 키 | 최대 20개 |
워크스페이스당 API 키 한도에는 개발자 콘솔에서 직접 만든 키 중 폐기하지 않은 키만 포함됩니다.
초당 호출 한도를 넘으면 429 RATE_LIMITED 오류와 함께 Retry-After 헤더가 반환됩니다. 같은 값이 오류 본문의 detail.retry_after_seconds에도 담깁니다.
안내된 시간(초)만큼 기다린 뒤 다시 요청하세요.
재시도 횟수에는 상한을 두는 것을 권장합니다.
한도에 걸린 요청은 금액이 차감되지 않습니다.
잔액이 부족하면 429가 아니라 402 INSUFFICIENT_BALANCE가 반환됩니다.이 오류는 기다려도 해결되지 않으므로 자동으로 재시도하지 말고, 잔액을 충전한 뒤 다시 요청하세요.
자세한 내용은 요금을 참고하세요.