인증
BizRouter의 모델 호출 API는 서비스 API Key로 인증합니다. 상태 확인 endpoint와 별도의 Usage API는 아래와 다른 인증 계약을 사용합니다.
API 키 형식
BizRouter API 키 구조와 특징 BizRouter API 키는 sk-br-v1- 접두사로 시작합니다. 보안 참고사항 API 키는 안전하게 해시되어 저장되며, 생성 시에만 전체 키를 확인할 수 있습니다. 키를 backend secret manager 또는 server 환경 변수에 보관하고, browser JavaScript, mobile app, frontend bundle이나 공개 저장소에 포함하지 마십시오.
인증 방법
API 요청에 인증 정보를 포함하는 방법
인증 방법 · 1. HTTP 헤더 인증 (권장)
다음 두 가지 방식 중 하나를 사용하여 API 키를 전달할 수 있습니다: Authorization: Bearer (OpenAI SDK 호환) X-API-Key (레거시) OpenAI SDK 호환 Authorization: Bearer 방식은 BizRouter가 지원하는 OpenAI-compatible endpoint에서 사용할 수 있습니다. 두 헤더가 모두 전달될 경우 Authorization: Bearer 가 우선 적용됩니다.
인증 방법 · 2. 선택적 헤더
추가 컨텍스트를 위한 선택적 헤더를 포함할 수 있습니다: X-Title 애플리케이션 이름을 지정하여 사용량 추적에 활용 X-BizRouter-Usage-Subject 최종 사용자 또는 workload 식별자 X-BizRouter-Usage-Group 팀, 서비스 또는 고객 조직 단위 식별자 X-BizRouter-Client-Request-Id 고객 시스템의 요청 ID. 사용량 로그 대조에 사용 Usage attribution header는 해당 API Key에서 사용량 귀속을 켠 경우에만 기록됩니다(콘솔 서비스 API 키 수정 창의 「사용량 귀속」 탭). 켜지 않은 키로 보내면 오류 없이 무시됩니다. 값은 최대 128자이며 영문자, 숫자, 점, 밑줄, 콜론, 하이픈을 사용할 수 있습니다.
API 키 관리
API 키 생성, 관리 및 보안 모범 사례
API 키 관리 · API 키 생성
BizRouter 대시보드에 로그인 설정 > API 연동 > 서비스 API 키 메뉴로 이동 "새 API 키 생성" 버튼 클릭 키 이름과 선택적 크레딧 한도 설정 생성된 키를 안전한 곳에 저장 (다시 확인 불가)
API 키 관리 · 보안 모범 사례
환경 변수를 통해 API 키 관리 소스 코드에 하드코딩 금지 정기적인 키 순환 (rotate) 최소 권한 원칙 적용 키별 크레딧 한도 설정
OpenAI SDK 사용
기존 OpenAI 클라이언트를 BizRouter와 함께 사용하기 BizRouter는 Authorization: Bearer 인증 방식을 지원하므로, OpenAI SDK의 Chat Completions 호출 방식을 사용할 수 있습니다. API Key와 base_url 을 BizRouter 값으로 설정하십시오.
권한 및 제한
API 키의 권한 범위와 사용 제한
권한 및 제한 · API 키 권한
조직 정책과 API Key의 model scope에서 허용된 모델에 접근 설정된 IP/CIDR allowlist에서만 호출 가능 owner 권한: 모든 API 키 관리 가능 member 권한: 본인 API 키만 관리 가능
권한 및 제한 · 사용 제한
조직별 월 사용량 한도 API 키별 크레딧 한도 (선택적) 분당 요청 수 제한 (Rate Limiting) API Key별 rate override가 설정된 경우 해당 제한 적용 분당 요청 한도는 누적 결제 금액에 따라 단계(Tier)로 자동 적용됩니다. 기준과 현재 단계는 관리/설정 > 크레딧/결제 화면에서 확인할 수 있고, 단계별 한도와 429 처리 방법은 요청 한도 에 있습니다. 크레딧 시스템 BizRouter는 선불(prepaid) 또는 후불(postpaid) 크레딧 시스템을 사용합니다. 크레딧이 소진되거나 한도에 도달하면 403 Forbidden 이 반환됩니다. 선불 크레딧은 소진과 진행 중 요청의 임시 예약을 서로 다른 error code로 구분하므로 오류 처리 문서를 함께 확인하십시오.