# 조직과 예산

> 역할, 멤버와 초대, 프로젝트와 키, 키 지출 한도와 만료, 월 예산, 크레딧과 만료, 결제, 서비스 상태를 설명합니다.

Source: https://kiln.bricksum.com/docs/ko/organizations

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으로 표시된 경우에는 운영팀이 크레딧을 지급합니다. contact@bricksum.com으로 문의하세요. 인보이스는 제공하지 않습니다.

## 상태와 공지

서비스 상태와 구성요소별 90일 가동률은 https://status.bricksum.com에서 공개합니다. 정비 일정 등의 공지는 콘솔과 랜딩 페이지의 공지사항에 게시합니다.

함께 보기: [사용량과 과금](https://kiln.bricksum.com/docs/ko/usage-billing) · [레이트 리밋](https://kiln.bricksum.com/docs/ko/rate-limits) · [에러](https://kiln.bricksum.com/docs/ko/errors) · [콘솔 → 조직](https://kiln.bricksum.com/app/org)

참고

콘솔에 coming soon으로 표시된 항목은 API로도 사용할 수 없습니다. API로 할 수 있는 일은 지금 콘솔에서 할 수 있는 일과 같습니다.