인증

모든 요청은 Authorization 헤더에 API 키를 Bearer 토큰으로 담아 인증합니다. 키는 sk-bk-로 시작하며 하나의 조직에 속합니다. x-api-key 헤더도 받지만 요청에 Authorization 헤더가 없을 때만 읽습니다. Bearer 형식이 아닌 Authorization 헤더는 x-api-key로 넘어가지 않고 401로 거부합니다.

키 관리

콘솔 → API 키에서 키를 발급하고, 이름을 붙이고, 폐기합니다. 전체 시크릿은 발급할 때 한 번만 표시되며, 이후에는 마스킹된 값만 보입니다.

• 애플리케이션·환경(prod, staging, local)별로 키를 분리해 발급하세요.
• 노출이 의심되면 즉시 키를 폐기하세요. 폐기는 즉시 반영됩니다.
• 주기적으로 키를 교체하세요. 보유 가능한 키 수에는 제한이 없습니다.

조직과 프로젝트

각 키는 하나의 조직과 프로젝트에 속합니다. 사용량과 크레딧 차감은 해당 조직 기준으로 집계되므로 과금과 레이트 리밋도 조직 단위로 적용됩니다. 콘솔에서 활성 조직을 전환해 해당 조직의 키와 크레딧을 관리하세요. 역할·초대·프로젝트·키 한도·예산·크레딧은 조직과 예산 페이지를 참고하세요.

요청이 거부되면 에러 페이지에서 401/403 상태 코드와 의미를 확인하세요.