속도 제한 및 동시성

현재 기본값은 IP당 분당 요청 180개, 키당 60개, 계정당 90개입니다. IP 제한은 인증된 요청에도 적용됩니다. 한 계정의 키는 계정 속도 제한을 공유합니다. 계정은 최대 5개의 데이터 요청을 동시에 실행할 수 있으며 각 키에는 구성된 max_concurrent_requests 제한도 있습니다. 본문은 256KB, 페이지는 50개 항목으로 제한됩니다.

일일 허용량은 하루에 성공한 REST 데이터 호출을 제한합니다. 1분 이내에 비율 제한 한도 요청; 동시성 상한 요청이 여전히 실행 중입니다. 확인에는 일일 데이터 호출이 사용되지 않지만 여전히 속도가 제한되어 있습니다. 한도를 낮추거나 다른 키를 생성해도 계정 일일 허용량을 우회하지 않습니다. 직렬 요청은 동시성을 감소시키지만 일일 허용량을 늘리지는 않습니다.

REST 데이터 호출이 10회에 도달하면 HTTP 429와 API_DAILY_LIMIT_REACHED를 반환합니다. Asia/Shanghai 기준 다음 00:00까지 기다리세요. 키를 만들거나 교체해도 계정 한도는 초기화되지 않습니다.

RATE_LIMITED에서는 Retry-After에 따라 간격을 두고 재시도하세요. 유효한 키, 권한, 호출 속도, 동시 실행 및 계정 제한은 계속 적용됩니다.

HTTP 429만 사용하는 것이 아니라 error.code를 사용하여 복구 경로를 선택하세요. RateLimit-Limit, RateLimit-Remaining 및 RateLimit-Reset은 단기 요율 창을 설명합니다. 재설정은 일일 재설정 시간이 아닌 초 단위의 Unix 타임스탬프입니다. 비율 창 소진은 초 단위로 Retry-After를 제공합니다. 동시성 또는 일일 허용량 429 응답에서는 이를 생략할 수 있습니다. 일일 사용량은 daily_usage를 읽고 일일 한도 오류는 error.details.daily_usage를 읽어보세요.

성공한 REST 데이터 요청은 빈 결과와 캐시 적중을 포함하여 1회로 계산됩니다. 같은 Idempotency-Key와 매개변수로 재시도하면 원래 결과를 반환하며 추가 횟수를 차감하지 않습니다. 실패한 요청과 304 응답은 일일 한도를 소모하지 않습니다.

RATE_LIMITED에서는 Retry-After에 따라 간격을 두고 재시도하세요. 유효한 키, 권한, 호출 속도, 동시 실행 및 계정 제한은 계속 적용됩니다.

RATE_LIMITED의 경우 먼저 Retry-After를 기다립니다. 없는 경우 동시성을 줄이고 작은 임의 지연과 재시도 제한이 있는 지수 백오프를 사용합니다. 예를 들어 요청 ID를 중지하고 기록하기 전에 1초, 2초, 4초를 기다립니다. 매 초마다 API_DAILY_LIMIT_REACHED를 다시 시도하지 마세요. 일일 재설정을 기다리세요. 401, 403 또는 잘못된 요청을 재시도하기 전에 인증, 권한 또는 매개변수를 수정하세요.

동일한 REST 데이터 작업을 재시도할 때 Idempotency-Key 및 매개변수를 변경하지 않고 유지하세요. 새로운 논리 연산을 위한 새로운 키를 생성합니다. 키를 재사용하는 동안 매개변수를 변경하면 IDEMPOTENCY_CONFLICT가 발생합니다. 다른 페이지를 다른 작업으로 처리합니다. 재시도 가능한 5xx 응답에도 제한된 백오프가 필요합니다.

한 계정의 두 키가 각각 5개의 데이터 호출을 완료하는 경우, 마지막 순간에 요청이 없더라도 공유된 10개 호출 REST 일일 허용량이 소진됩니다. 웹사이트에는 별도의 10개 검색 허용이 있습니다. MCP는 일일 허용량을 모두 사용하지 않지만 동시에 너무 많은 MCP 요청이 여전히 RATE_LIMITED를 트리거할 수 있습니다.