API 키의 쿼터, 크레딧 상한 & 만료

침해된 에이전트는 스스로 멈추지 않습니다. 그것을 재시도 루프에 빠뜨리는 프롬프트 인젝션이나, CI 로그의 유출된 키는 무언가가 멈추라고 말할 때까지 모델을 계속 호출합니다. OrcaRouter에서 그 “무언가”는 키 자체의 두 필드입니다: 지출 상한과 만료. 키 편집기에서 한 번 설정하면 게이트웨이가 모든 요청에서 둘 다 강제합니다 — 에이전트 코드 변경도, 재배포도 없이. 이 페이지는 그 두 제한에 대한 집중 레퍼런스입니다. 전체 키 필드 목록은 토큰 객체를 참조하세요; 그것들을 둘러싼 신원 모델은 범위 지정 키 개요를 참조하세요.

​

1. API 키 지출 한도: credit_limit_usd

credit_limit_usd는 키의 평생 지출 천장이며, 평범한 USD로 표현됩니다. 키 편집기에 달러 수치를 입력하면; OrcaRouter는 그것을 키의 시작 쿼터로 변환하고 모든 호출을 그에 대해 미터링합니다.

​

2. 상한이 미터링되는 방식: remain_quota & used_quota

당신이 입력하는 달러 상한은 사람을 향한 표면입니다. 그 아래에서, 게이트웨이는 키에서 두 개의 진행 카운터를 추적합니다: 양수 credit_limit_usd를 설정하면 그 달러 수치에서 remain_quota가 시드됩니다; 청구되는 모든 호출은 비용을 remain_quota에서 used_quota로 옮깁니다. 무제한 상한을 가진 키는 대신 unlimited_quota를 담으며, 잔액 검사가 전적으로 건너뛰어집니다.

​

3. 자동 만료: expired_time

expired_time은 절대 차단선입니다 — 그 이후 키가 인가를 멈추는 Unix 에포크 타임스탬프(초)이며, 예산이 얼마나 남았든 상관없습니다.

• 미래 타임스탬프는 그 순간에 키를 만료시킵니다. 게이트웨이는 모든 요청에서 그것을 현재 시각과 비교하고 그것이 지나면 호출을 거부합니다.
• **-1**은 절대 만료되지 않음의 센티넬입니다.

CI 실행마다 또는 임시 에이전트마다 발행되는 단명 키에 대해서는 만료 키를 참조하세요.

​

4. 하나의 구체적인 상한 적용 만료 키

저렴한 모델 하나로 인보이스를 대조하고, 2주 파일럿 동안 실행되며, 밤마다 몇 달러 이상 들어서는 안 되는 야간 작업은 거의 권한이 필요 없습니다. 콘솔 키 편집기 (/console/token — Developer+)에서 그 키를 구성하세요: 이 에이전트가 셋째 날에 탈취되면, 피해는 남은 $40에 한정되며, 어쨌든 키 전체는 11일 안에 사라집니다. 워크스페이스의 나머지는 손대지 않습니다.

​

5. 누가 이것을 설정할 수 있는가

credit_limit_usd와 expired_time 설정은 키를 생성하거나 편집하는 것의 일부이며, Developer 역할 이상이 필요합니다. 모든 워크스페이스 멤버는 키의 마스킹된 레코드를 읽을 수 있습니다; Developer+만 그 제한을 변경할 수 있습니다. 키는 표시 시 마스킹됩니다 — 평문은 생성 시 한 번 표시됩니다 (see 키 마스킹).

​

6. 기본적으로 Bounded

credit_limit_usd: 0 그리고 expired_time: -1을 가진 키는 지출 상한이 없고 결코 만료되지 않습니다 — 최대 권한, 최악의 피해 반경. 그 조합을 기본값이 아니라 의도적인 예외로 만드세요.

​

7. 관련

지출 상한과 만료는 키에 대한 가장 저렴한 보험입니다: 두 개의 숫자가 무한정의 자격 증명을 — 청구서가 알아챌 때까지 실행되는 대신 — 비거나 만료되어 안전하게 실패하는 것으로 바꿉니다.