속도 제한

속도 제한은 사용자나 클라이언트가 지정된 기간 내에 저희 서비스에 접근할 수 있는 횟수를 제한하는 API 제한 사항입니다.


제한이 필요한 이유

저희는 모든 분들께 최상의 경험을 제공하기 위해 API에 속도 제한을 두고 있습니다. 이유는 다음과 같습니다:

  • 서비스를 안전하게 지키기 위해서입니다! 속도 제한을 친절한 문지기라고 생각해 보세요 - 한 번에 너무 많은 요청이 API에 몰려들지 않도록 지켜줍니다. 이는 서비스를 잠재적인 오남용으로부터 보호하고 모든 것이 원활하게 돌아가도록 도와줍니다.

  • 모두가 공평한 몫을 받을 수 있도록 하기 위해서입니다. 놀이터에서 장난감을 함께 나눠 쓰는 것처럼, 모든 사용자가 API에 동등하게 접근할 수 있도록 하고자 합니다. 각 사용자가 보낼 수 있는 요청 수를 적절히 제한함으로써, 누구도 자신의 차례를 너무 오래 기다리지 않도록 보장합니다.

  • 빠르고 안정적인 성능을 유지하기 위해서입니다. 전체 요청 흐름을 관리함으로써, 모든 훌륭한 사용자분들께 빠른 응답 시간과 안정적인 서비스를 유지할 수 있습니다. 마치 고속도로가 너무 혼잡해지지 않도록 하는 것과 같습니다 - 정체를 막으면 교통 흐름이 더 원활해지니까요!


제한 작동 방식

속도 제한은 두 가지 방식으로 측정됩니다:

  • 초당 요청 수: 초당 보낼 수 있는 네트워크 요청 수입니다.
  • 대기열 작업: 특정 시점에 대기열에서 동시에 실행할 수 있는 생성 작업 수입니다.

대기열 작업에는 텍스트로 3D, 이미지로 3D, 텍스트로 텍스처, 리메시 엔드포인트가 포함됩니다. 업로드 및 잔액과 같은 다른 엔드포인트는 이 제한에 포함되지 않습니다.

이러한 제한은 계정 단위로 적용됩니다. 즉, 귀하의 모든 API key에서 이 제한이 공유됩니다.

속도 제한 외에도, 작업 처리 우선순위 역시 작업 속도에 영향을 미칩니다.

각 사용자 등급마다 그에 맞는 특정 속도 제한과 우선순위 수준이 설정되어 있습니다. 현재 등급별 제한은 다음과 같습니다:

사용자 등급초당 요청 수대기열 작업우선순위 수준
Pro2010기본값
Premium2030Pro보다 높음
Ultra20100최고
Studio2020Pro보다 높음
Enterprise100기본값 100, 맞춤 설정 가능최고

이러한 제한을 초과하면, 저희 API로부터 429 Too Many Requests 응답을 받게 됩니다. 이를 발생시킬 수 있는 상황은 두 가지이며, 각각 다른 응답을 반환합니다:

  • 요청 초과: 초당 너무 많은 요청을 보낼 때 발생합니다. RateLimitExceeded 메시지와 함께 429 Too Many Requests 응답을 받게 됩니다.
  • 대기열 초과: 동시에 실행 중인 생성 작업이 너무 많을 때 발생합니다. NoMoreConcurrentTasks 메시지와 함께 429 Too Many Requests 응답을 받게 됩니다.