사용량 할당 회계

다음으로 시작 사용량 할당 설정을 위해. 규칙은 하나의 작업 영역에 있는 하나의 전용 리소스 그룹에 속합니다. 규칙이 존재하는 동안 해당 계정 멤버십은 고정된 상태로 유지됩니다. 회원에게는 직접 풀 부여와 규칙에 바인딩된 개인 키가 필요합니다. 일반 키는 자동으로 변환되지 않습니다. 규칙에 대한 한 구성원의 키는 모두 하나의 원장을 공유합니다.

총예산 비중

비율 기준은 일별·월별 총예산이나 최대 8개 경과 시간 창별 총예산을 지원합니다. 합계 100% 이하인 동일한 구성원 비율을 모든 선택한 창에 적용하며 토큰 또는 내부 USD로 측정합니다.

• 토큰 공유 기준: M 토큰으로 합계를 입력하세요. 보고된 입력 및 출력 토큰은 각 회원의 지분에 포함됩니다. 캐시된 입력은 입력의 일부이며 두 번 계산되지 않습니다.
• 금액별 공유: 내부 USD 합계를 입력합니다. 각 요청의 입력, 캐시된 입력 및 출력은 해당 규칙 개정과 함께 저장된 모델 가격을 사용하여 변환됩니다. 이 가격에는 공급자의 구독 청구 공식이 명시되어 있지 않습니다.

각 창의 개인 한도는 해당 창의 총예산에 비율을 곱해 최소 단위로 내림한 값입니다. 예를 들어 1 M 토큰의 25%는 0.25 M입니다. 양의 비율이 0으로 내림되는 설정은 거부합니다. 미배분 비율과 반올림 잔여분은 자동 대여하지 않습니다. 새 요청은 개인 한도와 그룹 총예산을 모두 검사하고 떠난 구성원의 소비도 포함합니다. 그룹 내 구독 계정별로 예산을 새로 시작하지 않습니다.

이들은 내부 예산. 구성된 토큰 합계는 구독의 실제 용량을 나타내지 않으며 내부 USD은 현금 잔액이나 송장이 아닙니다. SubLane은 여전히 ​​사용 가능한 업스트림 할당량을 확인합니다. 공급자는 내부 예산이 소진되기 전에 요청을 거부할 수 있습니다.

기간 금액 한도

시간대별은 별도의 할당 방식입니다. 정수 시간·일수(1시간부터 365일)와 공통 내부 USD 상한을 최대 8개까지 설정합니다. 구성원은 독립적으로 집계되며 조건별 상한을 재정의할 수 있습니다. 이 방식에서 상한을 비우면 해당 조건은 무제한으로, 사용량만 기록하고 한도·임시 예약을 적용하지 않습니다. 확정된 요청은 저장 가격으로 한 번 계산한 뒤 모든 창에 반영합니다. 유한 조건이 소진되거나 예약 여유가 부족하면 새 요청을 중지합니다.

경과 시간 창은 적용 기준점부터 각각 고정 길이로 갱신됩니다. 5시간 창의 초기화가 7일 사용량을 지우지 않습니다. 이동식 과거 조회 한도가 아니며 상위 구독의 초기화와 동기화하지 않습니다. 인스턴스 시간대는 표시만 바꾸고 경과 시간은 바꾸지 않습니다.

구성원 수정과 예약 변경

「현재 회원 수정」으로 비율이나 개인 한도를 즉시 바꿀 수 있습니다. 기존 소비와 이미 허용된 요청의 예약량은 유지합니다. 증액은 모든 현재 공유 창의 예산 안에 들어야 하며, 삭제 후 재가입해도 사용량은 지워지지 않습니다. 총예산 100에서 A가 40을 썼다면 A/B/C 각 33은 106이 필요해 거부되지만 40/30/30은 가능합니다. 주기 갱신 후에도 모든 창을 다시 검사하며 일반 예약으로 부족분을 우회할 수 없습니다.

예산·창 기본 상한·가격은 기존 예약 시각이나 현재 계획의 다음 경계에 반영합니다. 여러 창이면 현재 최장 창의 다음 경계를 사용합니다. 기준점·경계·소비량을 유지하므로 짧은 창이 진행 중일 때 상한을 낮추면 이미 소진된 상태가 될 수 있습니다. 새 가격으로 과거 요청을 다시 계산하지 않습니다.

일반 예산·가격 편집은 저장된 구성원 설정을 그대로 유지합니다. 현재 권한 목록에서 빠진 사람의 설정을 남겨도 접근 권한이 복구되지는 않습니다. 새 수령자와 새 구조의 기간은 현재 그룹 권한을 검증해야 합니다.

다음 버전에 별도 구성원 계획이 있으면 즉시 변경의 자동 투영은 충돌로 거부합니다. 해당 예약을 명시적으로 검토하거나 취소해야 합니다. 다른 호환 예산·가격 예약은 보존합니다. 백그라운드 갱신은 예전 초안에 새 버전 조건을 붙이지 않으며, 충돌 후 「새로고침 후 검토」를 사용합니다.

단위·할당 방식·초기화 계획 변경은 실제 구조가 다른 교체로 확인해야 합니다. 규칙·그룹·Key ID를 유지하고 예약 적용 시각을 새 측정 기준점으로 삼습니다. 구성원이나 가격만 바꿔 새 기간을 만들 수는 없습니다.

「다음 경계까지 연기」는 저장된 적용 시각보다 엄격히 뒤에 있는 첫 자연 경계로만 이동합니다. 현재 계획을 사용하며 첫 적용 전에는 초기 예약 계획을 사용합니다. 서버 시각을 검토해 확인하고, 조건 만료·변경은 충돌로 반환합니다.

「예약 변경 취소」에는 현재 유효한 버전이 필요합니다. 초기 예약만 있으면 일시 중지하거나 연기합니다. 초기 연기는 하나의 트랜잭션에서 전체 버전을 교체합니다. 일시 중지는 예약 시각이나 읽을 수 있는 설정을 없애지 않으며 초기 버전 적용 후에도 접근을 막습니다.

첫 적용 전 초기 구성원 수정에는 전체 편집기(PATCH /api/allocations/{id})를 사용합니다. 검토한 현재/다음 버전 조건과 적용 시각이 필요하며, 저장된 시각과 기준점을 유지하고 대상 구성원의 현재 그룹 권한을 다시 확인합니다. 현재 버전과 기록된 요청이 모두 없는 초기 예약에만 허용됩니다. 버전·메타데이터·감사를 하나의 트랜잭션으로 저장하며 실패나 적용 시각 통과 시 모두 되돌립니다. 초기 예약 취소는 여전히 금지됩니다.

승인된 다음 버전이 현재 버전과 실제로 구조가 다르면 초안이 다음 버전 구조를 유지해도 기존 새 기간 확인을 표시합니다. 다시 확인하면 예약 대상 구성원을 수정할 수 있습니다. 일반 예산·가격 편집은 재확인 없이 구성원과 기준점을 보존합니다. 이 선택적 재확인을 해제하면 저장된 구성원 계획을 표시하고 전송합니다. 교체에는 현재 버전과의 실제 구조 차이가 계속 필요합니다.

가격이 책정된 할당량(금액별, 금액별 공유, 그리고 시간대별), SubLane은 전용 풀에서 지원되는 모델을 읽고 개정을 저장할 때 카탈로그 가격을 채웁니다. 사용자 제공 가격은 이 스냅샷을 재정의하지 않습니다. 모델에 현재 카탈로그 가격이 없는 경우 이전에 저장된 요금이 사용 가능할 때 재사용됩니다. 가격이 없는 새로 검색된 모델은 스냅샷에서 생략되므로 가격이 책정된 개정이 적용될 때까지 해당 모델에 대한 요청이 차단된 상태로 유지됩니다. 가격 적용 경고는 규칙을 읽을 때 계산되며 개정판에 저장되지 않습니다. 복원된 카탈로그 가격은 카탈로그 경고를 자동으로 지우는 반면, 저장된 가격 스냅샷에 없는 모델은 새 개정판에 포함될 때까지 플래그가 표시된 상태로 유지됩니다. 사용할 수 없는 계정 카탈로그는 이전에 저장된 요금을 유지하고 검색이 복구될 때까지 경고를 표시합니다. 사용 가능한 가격이 남아 있지 않은 경우에만 저장이 실패합니다. 로드된 가격 카탈로그나 저장된 가격 캐시가 없으면 새로운 가격 허용량을 생성할 수 없습니다. 다시 시도하기 전에 카탈로그를 새로 고치거나 가격 대체를 제공하세요.

저장 가격에 없는 모델은 지금 저장한 수정 버전이 언제 반영될지 관리자에게 표시합니다. 시간 창 규칙은 현재 최장 창의 다음 경계를 사용하므로 반복 저장해도 즉시 사용할 수 없습니다. 기존 예약은 저장된 적용 시각을 표시하고 수정 버전으로 교체하지 않으면 적용 후에도 해당 모델이 거부됨을 알립니다.

직접 한도 및 보류 중인 사용량

토큰으로 회원의 토큰 한도를 직접 설정합니다. 금액별 저장된 모델 가격을 사용하여 직접 내부 USD 한도를 설정합니다. 둘 다 해당 공유 기준과 동일한 토큰 또는 가격 회계를 사용합니다.

신뢰할 수 있는 최종 사용량은 상위 비율 갱신을 기다리지 않고 확정합니다. 총량이 없으면 수정 대기로 남기고 부분 관측값은 보이지만 소비·예약으로 계산하지 않습니다. 실행 중 요청은 허용 시 포착한 개인 상한의 10%(최소 1단위)를 각 유한 창에서 임시 예약하며 나중 편집으로 바꾸지 않습니다. 각 유한 창에서 같은 구성원은 그 창의 요청을 최대 4개 동시에 실행하고 공유 예산은 그룹 전체 노출도 검사합니다. 종료 시 예약을 해제합니다. 큰 요청의 초과와 미확정 사용량이 가능하므로 소프트 한도입니다. 최신 대기 기록 256개를 먼저 보여 주고 수정하면 오래된 기록이 다시 나타납니다. 집계 시각은 대기열 이후 허용 성공 시각이며 진단 소요 시간은 도착부터 계산합니다.

Codex 스트림의 경우 SubLane은 신뢰할 수 있는 최종 사용량을 캡처하기 위해 클라이언트 연결이 끊어진 후 최대 3초 동안 업스트림을 계속 읽을 수 있습니다. 전체 사용이 포함된 실패한 터미널 이벤트에도 요금이 부과될 수 있습니다. 업스트림 오류가 반복되면 영향을 받은 계정이 일시적으로 냉각됩니다. 최종 사용 없이 성공적인 응답은 계정을 냉각하지 않고 보류 상태로 유지됩니다. 회계 쓰기가 일시적으로 실패하면 SubLane 영향을 받은 회원에 대한 추가 할당량 지원 작업을 허용하기 전에 해당 요청을 다시 시도합니다. 다른 회원들은 계속할 수 있습니다.

일별·월별 규칙은 인스턴스 시간대의 지정 시각·날짜를 사용하며 없는 월일은 그달 마지막 날로 맞춥니다. 기본값은 매일 00:00 또는 매월 1일 00:00입니다. 일반 편집은 측정 기준점을 유지합니다. 일시 중지와 권한 취소는 이후 요청·WebSocket 턴을 차단하지만 기록은 남깁니다. 상위 할당량 갱신, 초기화 카드, 재인증, 재시작은 로컬 예산을 충전하지 않습니다.

선택 다음 기간 시작 시간 범위 규칙을 생성하면 구성된 기간 중 가장 긴 후에 시작됩니다.

잔액을 읽고 수정하세요

회원은 아래에서 자신의 허용량을 볼 수 있습니다. 용법. 워크스페이스 관리자 공개 사용량 할당 → 사용량 보기 완전한 규칙을 위해. 구성된 모든 시간 창은 한도, 사용 금액, 남은 금액, 위험 노출 및 재설정 즉시 한 구성원 아래에 표시됩니다. 회원 상태는 가장 제한적인 조건을 반영합니다. 금액 잔액은 보고된 토큰과 함께 내부 USD을 표시합니다. 토큰 잔액은 M을 사용합니다. 1 M = 1,000,000 tokens. 개인 보고서는 구독 계정 ID를 노출하지 않습니다.

잔액이 분리됩니다 사용된 (정산된 사용량)은 현재 주기에서 진행 중인 요청 및 보류 중인 사용량입니다. 임시 예약은 기내 요청만 반영합니다. 보류 중인 사용량은 수정을 위해 계속 표시되며 사용된 허용량 또는 예비 용량으로 계산되지 않습니다. 승인 헤드룸에는 자동 위험 완충 장치가 포함됩니다. 이는 추가로 지출할 수 있는 할당량이 아닙니다. 따라서 긍정적인 잔여 할당량은 다음과 일치할 수 있습니다. 새 요청 일시 일시 일시 일시 정지 다른 요청에 현재 헤드룸보다 더 많은 예약이 필요하거나 4개의 요청이 아직 진행 중인 경우. 상태는 게이트웨이 승인과 동일한 현재 주기 위험 검사를 따릅니다. 이는 스냅샷이며 요청이 완료되면 변경될 수 있습니다. 현재 주기 외부의 보류 중인 기록은 수정을 위해 계속 표시되지만 승인을 일시 중지하지는 않습니다.

보류 중인 항목을 자동으로 해결할 수 없는 경우 관리자는 신뢰할 수 있는 증거가 뒷받침하는 입력, 출력 및 캐시된 입력 합계를 입력할 수 있습니다. 수정 시 요청의 저장된 회계 규칙을 사용하고 감사 이벤트를 기록합니다. 누락된 사용량을 0으로 처리하거나 발명된 총계를 입력하지 마십시오.

Workspace 관리자는 다음에서 규칙을 관리합니다. /api/allocations; 회원들은 자신의 잔액을 확인합니다. /api/me/allocations. 키는 다음을 사용하여 규칙에 바인딩됩니다. scheme_id. 보다 작업 공간 그리고 개인 API 키.

API 쓰기 조건

읽기는 기존 응답 형식을 유지하고 write_conditions에 null을 허용하는 expected_current_revision_id와 expected_next_revision_id를 추가합니다. 기존 규칙의 전체 PATCH, 구성원 변경, 취소·연기, 구조 교체에는 두 필드가 모두 필수입니다. 누락·오래된 조건은 설정을 바꾸지 않고 HTTP 409를 반환합니다. 새 ID로 예전 초안을 자동 재전송하지 말고 다시 검토하세요. 독립 활성화·중지 및 요청별 사용량 수정은 기존 계약을 유지합니다.

미래 버전 쓰기에는 서버가 확인한 UTC 초 단위 expected_effective_at이 필요하며 구조 교체에는 confirm_replacement=true도 필요합니다. POST /api/allocations/{id}/preview의 작업은 schedule, reschedule, replace입니다. 구성원은 POST /api/allocations/{id}/members, 예약은 POST /api/allocations/{id}/cancel, POST /api/allocations/{id}/reschedule을 사용합니다. 활성화 여부는 전체 저장으로 바꾸지 말고 POST /api/allocations/{id}/enabled를 사용합니다.

첫 생성에 시간 조건이 없으면 기존 즉시·지연 시작을 유지합니다. expected_effective_at을 보내면 start_next=true가 필요합니다. 달력 시작은 다음 경계와 일치해야 하며, 경과 시간 시작은 서버 현재 시각보다 미래이면서 최장 기간 이내여야 합니다. 명시적 null은 필수 조건 누락으로 409, 잘못된 형식은 400, 만료·변경은 409입니다. POST /api/allocations/preview는 초기 시각만 반환하고 규칙을 만들지 않으며 확인 실패 시 무조건 생성으로 전환하지 않습니다.