API 레퍼런스
로그인
본문으로 건너뛰기

속도 제한과 티어

조직은 누적 충전액으로 정해지는 사용 티어에 따라 동시 실행 잡 수와 월 사용 한도를 가집니다, 티어 표와 상향 규칙, API 요청 속도 정책을 설명합니다

조직마다 사용 티어가 있고 티어는 동시 실행 잡 수, 조직 대기열 상한, 월 사용 한도를 정합니다, 티어는 누적 충전액으로 자동 상향되고 내려가지 않습니다

참고 아래 티어 표는 초안이며 승인 전까지 바뀔 수 있습니다, 지금 적용 중인 값은 콘솔 분석 → 한도 또는 티어 표 API가 돌려주는 값입니다(policy.status가 draft인 동안은 초안)

티어 표

티어진입 누적 충전액동시 실행 잡조직 대기열 상한월 사용 한도
Tier 1US$5 (첫 충전)210US$100
Tier 2US$40320US$500
Tier 3US$200440US$2,000
Tier 4US$400660US$5,000
Custom협의880없음
  • 금액은 모두 부가세 포함입니다
  • 런칭가 US$0.0396/분 기준으로 Tier 1 월 한도 US$100은 약 2,525분입니다

규칙

규칙내용
단위조직(지갑) 단위, 워크스페이스나 키 단위가 아닙니다
기준결제가 확정된 충전 주문의 USD 합계, 7일 청약철회로 돌려받은 금액은 누적에서 뺍니다
상향충전이 적립되는 순간 다시 계산합니다
강등없습니다, 청약철회로 누적액이 줄어도 티어는 그대로입니다
월 기준UTC 달력 월, 다음 달 1일 00:00 UTC에 사용액이 0에서 시작합니다
Custom운영자가 지정합니다, 분석 → 한도의 티어 상향 요청을 누르면 지원팀 메일이 열립니다

동시 실행 한도에 닿으면

실행 중(준비 중 포함)인 잡이 티어의 동시 실행 수에 닿으면 새 잡은 거절되지 않고 대기열에 들어갑니다(status = queued, queued_reason = tier_concurrency_limit), 슬롯이 비면 조직 안에서 가장 오래 기다린 잡부터 시작합니다

대기열까지 가득 차면 429 tier_concurrency_limit이고 응답에 retry_after_s(60초)와 details.running, details.queued, details.max_queued가 있습니다

풀 전체가 바쁠 때는 실행 중인 잡이 가장 적은 조직에 다음 빈 슬롯이 갑니다, 실행 중인 잡을 빼앗지는 않습니다

월 사용 한도에 닿으면

이번 달 정산액에 실행 중인 잡이 이미 쓴 금액을 더한 값이 티어 월 한도 이상이면 새 잡은 402 tier_monthly_limit입니다, 실행 중인 잡은 끝까지 돕니다, 응답의 details.resets_at이 풀리는 시각입니다

한도의 75%, 90%, 100%에 닿으면 소유자와 관리자에게 메일이 갑니다, 워크스페이스에 더 낮은 한도를 두면 둘 중 먼저 닿는 쪽이 적용됩니다(지출 한도)

한도 확인하기

콘솔 분석 → 한도에 현재 티어, 누적 충전액, 동시 실행과 대기열, 월 사용량과 한도, 워크스페이스별 지출 한도, API 요청 수가 보입니다

curl "https://xenoci.com/api/runner/v1/limits" \
  -H "Authorization: Bearer $XENOCI_API_KEY"

한도 조회, 조직 티어 조회, 티어 표를 보세요

API 요청 속도

대상정책
API 키 요청지금은 강제하지 않습니다, 키 하나가 10분에 1,000건을 넘으면 소유자와 관리자에게 급증 알림 메일만 갑니다(/v1/limits의 api_requests.enforced가 false)
로그인 메일 요청이메일당 15분에 5번, IP당 15분에 20번, 넘으면 429 rate_limited와 Retry-After 헤더
요청 본문JSON 64 KB 이하, 소스 업로드 2 GiB 이하

429나 503을 받으면 retry_after_s만큼 기다린 뒤 같은 Idempotency-Key로 다시 보내세요, 잡이 두 번 만들어지지 않습니다

다음 단계