속도 제한
속도 제한은 사용자나 클라이언트가 지정된 기간 내에 저희 서비스에 접근할 수 있는 횟수를 제한하는 API 제한 사항입니다.
제한이 필요한 이유
저희는 모든 분들께 최상의 경험을 제공하기 위해 API에 속도 제한을 두고 있습니다. 이유는 다음과 같습니다:
-
서비스를 안전하게 지키기 위해서입니다! 속도 제한을 친절한 문지기라고 생각해 보세요 - 한 번에 너무 많은 요청이 API에 몰려들지 않도록 지켜줍니다. 이는 서비스를 잠재적인 오남용으로부터 보호하고 모든 것이 원활하게 돌아가도록 도와줍니다.
-
모두가 공평한 몫을 받을 수 있도록 하기 위해서입니다. 놀이터에서 장난감을 함께 나눠 쓰는 것처럼, 모든 사용자가 API에 동등하게 접근할 수 있도록 하고자 합니다. 각 사용자가 보낼 수 있는 요청 수를 적절히 제한함으로써, 누구도 자신의 차례를 너무 오래 기다리지 않도록 보장합니다.
-
빠르고 안정적인 성능을 유지하기 위해서입니다. 전체 요청 흐름을 관리함으로써, 모든 훌륭한 사용자분들께 빠른 응답 시간과 안정적인 서비스를 유지할 수 있습니다. 마치 고속도로가 너무 혼잡해지지 않도록 하는 것과 같습니다 - 정체를 막으면 교통 흐름이 더 원활해지니까요!
제한 작동 방식
속도 제한은 두 가지 방식으로 측정됩니다:
- 초당 요청 수: 초당 보낼 수 있는 네트워크 요청 수입니다.
- 대기열 작업: 특정 시점에 대기열에서 동시에 실행할 수 있는 생성 작업 수입니다.
대기열 작업에는 텍스트로 3D, 이미지로 3D, 텍스트로 텍스처, 리메시 엔드포인트가 포함됩니다. 업로드 및 잔액과 같은 다른 엔드포인트는 이 제한에 포함되지 않습니다.
이러한 제한은 계정 단위로 적용됩니다. 즉, 귀하의 모든 API key에서 이 제한이 공유됩니다.
속도 제한 외에도, 작업 처리 우선순위 역시 작업 속도에 영향을 미칩니다.
각 사용자 등급마다 그에 맞는 특정 속도 제한과 우선순위 수준이 설정되어 있습니다. 현재 등급별 제한은 다음과 같습니다:
| 사용자 등급 | 초당 요청 수 | 대기열 작업 | 우선순위 수준 |
|---|---|---|---|
| Pro | 20 | 10 | 기본값 |
| Premium | 20 | 30 | Pro보다 높음 |
| Ultra | 20 | 100 | 최고 |
| Studio | 20 | 20 | Pro보다 높음 |
| Enterprise | 100 | 기본값 100, 맞춤 설정 가능 | 최고 |
이러한 제한을 초과하면, 저희 API로부터 429 Too Many Requests 응답을 받게 됩니다. 이를 발생시킬 수 있는 상황은 두 가지이며, 각각 다른 응답을 반환합니다:
- 요청 초과: 초당 너무 많은 요청을 보낼 때 발생합니다.
RateLimitExceeded메시지와 함께429 Too Many Requests응답을 받게 됩니다. - 대기열 초과: 동시에 실행 중인 생성 작업이 너무 많을 때 발생합니다.
NoMoreConcurrentTasks메시지와 함께429 Too Many Requests응답을 받게 됩니다.