속도 제한

플랜에서 허용하는 요청 수와 작업 수, 그리고 한도에 도달했을 때 해야 할 일을 확인하세요.

---

플랜별 한도

API를 빠르고 모두에게 안정적으로 제공하기 위해, Meshy는 각 계정에 두 가지 방식으로 제한을 둡니다:

• 초당 요청 수: 매 초마다 보낼 수 있는 API 요청 수입니다.
• 동시 작업 수: 동시에 PENDING 또는 IN_PROGRESS 상태일 수 있는 작업의 수입니다.

한도는 플랜에 따라 다릅니다:

우선순위는 한도가 아닙니다. 대기열이 바쁠 때, Meshy는 우선순위가 더 높은 작업을 먼저 시작합니다.

각 한도에 포함되는 항목

작업을 가져오거나(get), 목록을 조회하거나(list), 스트리밍하는 요청을 포함해 모든 API 요청은 초당 요청 수에 포함됩니다. Meshy 웹 앱에서 발생하는 요청은 포함되지 않습니다.

동시 작업 수 한도는 요청이 아니라 작업 수를 기준으로 계산됩니다. 작업을 생성하는 모든 엔드포인트는 작업을 생성하기 전에 이 한도를 확인합니다. 예를 들어 텍스트로 3D, 이미지로 3D, 멀티 이미지로 3D, 리텍스처, 리메시, 리깅, 애니메이션, 텍스트로 이미지, 3D 프린팅 엔드포인트, 그리고 Creative Lab이 이를 확인합니다.

작업을 생성하지 않는 요청은 이 한도에 포함되지 않습니다. 예를 들어 잔액, 사용량, 그리고 작업을 가져오거나(get), 목록을 조회하거나(list), 스트리밍하는 요청은 포함되지 않습니다.

누구의 한도가 적용되는가

다음 표는 API 키, 플레이그라운드, 웹 앱이 누구의 한도에 포함되는지를 보여줍니다:

---

한도에 도달했을 때

한도를 초과하면 API는 429 Too Many Requests를 반환합니다. 메시지는 어떤 한도에 도달했는지 알려줍니다:

• 초당 요청 수 초과: 메시지는 Rate limit exceeded입니다. Retry-After 헤더에 명시된 초만큼 기다린 다음 다시 시도하세요.
• 동시 작업 수 초과: 메시지는 NoMorePendingTasks로 시작합니다. 크레딧이 남아 있지 않은 무제한 플랜에서는 NoMoreConcurrentTasks로 시작합니다. 이 429에는 Retry-After 헤더가 없습니다. 진행 중인 작업 중 하나가 끝날 때까지 기다린 후 다음 작업을 생성하세요.

---

속도 제한 헤더

API 응답에는 요청 속도를 조절할 수 있도록 다음 헤더가 포함됩니다:

Retry-After가 포함되어 있으면, 다음 요청을 보내기 전에 그만큼의 초 동안 기다리세요.