조직과 예산
API로 하는 모든 작업은 조직 단위로 관리됩니다. 키, 사용량, 크레딧, 예산, 레이트 리밋이 모두 조직에 속합니다. 이 페이지는 조직·멤버·프로젝트·키가 어떻게 연결되는지, 어떤 한도를 설정할 수 있는지, 크레딧과 결제가 어떻게 동작하는지 설명합니다.
조직과 역할
가입하면 본인이 소유자인 개인 조직이 만들어집니다. 조직에는 소유자가 정확히 한 명 있고, 관리자와 멤버는 여러 명일 수 있습니다. 관리자는 키·프로젝트·멤버·예산·설정을 관리하고, 멤버는 콘솔을 읽기 전용으로 쓰며 키를 발급할 수 없습니다. 개인 조직에는 멤버 관리가 없습니다. 다른 조직에서 작업하려면 콘솔에서 활성 조직을 전환하세요.
멤버와 초대
관리자는 조직 → 멤버에서 이메일로 멤버를 초대합니다. 대기 중인 초대는 취소하거나 다시 보낼 수 있고, 같은 주소를 두 번 초대할 수 없습니다. 초대받은 사람은 로그인 후 이메일 링크에서 수락합니다. 팀 조직에서는 조직 → 멤버에서 관리자가 멤버 역할을 변경하고, 소유자가 다른 멤버에게 소유권을 이전하며, 소유자가 아닌 멤버는 조직을 탈퇴합니다. 배포 환경이 아직 이 기능을 지원하지 않으면 콘솔에 coming soon으로 표시됩니다.
프로젝트와 키
프로젝트는 조직 안에서 키를 묶는 단위입니다. 모든 조직은 Default 프로젝트로 시작합니다. 각 API 키는 정확히 하나의 프로젝트에 속하며, 관리자가 API 키 페이지에서 이름만 입력해 발급합니다. sk-bk-로 시작하는 비밀값은 한 번만 표시됩니다. 사용량은 키·프로젝트·조직별로 집계되므로 사용량 페이지에서 어느 기준으로든 나눠 볼 수 있습니다.
키 한도와 수명
관리자는 발급한 키에 다음을 설정할 수 있습니다. USD 지출 한도를 두면 키의 누적 지출이 한도에 도달했을 때 요청이 거부되며, 비워 두면 무제한입니다. 만료일을 두면 그날이 끝난 뒤의 요청이 거부됩니다. 키를 일시중지하면 재활성화할 때까지 요청이 거부됩니다. 키를 삭제하면 즉시, 영구적으로 폐기됩니다. 키 목록에는 한도 대비 지출과 만료 상태가 표시됩니다. 거부 사유별 상태 코드는 에러 페이지에 정리되어 있습니다.
월 예산
관리자는 조직 → 설정에서 USD 월 예산을 설정할 수 있습니다. 이달 지출이 예산의 80%에 이르면 콘솔에 경고 배너가, 100%에 이르면 빨간 배너가 표시되고, 그때부터 조직의 모든 API 요청은 달이 바뀌거나 예산을 올릴 때까지 거부됩니다(상태 코드는 에러 페이지를 참고하세요). 예산이 없으면 무제한입니다.
레이트 리밋
분당 요청 수, 분당 토큰 수, 동시 요청 수는 조직 단위로 제한됩니다. 값은 운영팀이 관리하며 조직 → 개요에 읽기 전용으로 표시됩니다. 더 높은 한도가 필요한 부하 테스트는 실행 전에 문의하세요.
크레딧과 만료
크레딧은 USD 선불이며 만료됩니다. 체험 크레딧은 지급 후 30일, 구매한 크레딧은 구매 후 365일 뒤에 만료됩니다. 크레딧 페이지에는 잔액, 모든 지급·차감·환불·만료 원장, 30일 내 만료 예정 금액이 표시됩니다. 잔액이 부족해지면 조직 소유자에게 이메일이 한 번 발송됩니다.
결제와 영수증
콘솔에 충전 기능이 열려 있으면 카드로 크레딧을 구매합니다. 청구 통화와 VAT는 결제 서비스가 정하며, 결제 전에 결제 화면에 표시됩니다. 현재는 크레딧 금액에 10% VAT를 더해 KRW로 청구됩니다. 구매한 크레딧은 USD로 잔액에 더해집니다. 결제 페이지에는 각 결제의 상태·금액·VAT·수단·영수증 링크·환불 상태가 나열됩니다. 충전이 coming soon으로 표시된 경우에는 운영팀이 크레딧을 지급합니다. [email protected]으로 문의하세요. 인보이스는 제공하지 않습니다.
상태와 공지
서비스 상태와 구성요소별 90일 가동률은 https://status.bricksum.com에서 공개합니다. 정비 일정 등의 공지는 콘솔과 랜딩 페이지의 공지사항에 게시합니다.