기존 엔터프라이즈 API에서 옮겨오기
OpenAI·Anthropic·Google 등에 직접 연결해 쓰던 서비스를 BizRouter로 옮기는 절차입니다. 코드에서 바뀌는 것은 API 키와 base_url 두 줄이고, 모델 코드는 카탈로그의 코드로 맞춥니다. 나머지 통제·한도·감사는 콘솔에서 정합니다.
1. 엔드포인트 대응표
SDK는 그대로, 주소만 바꿉니다 기존 기존 base URL BizRouter base URL 인증 OpenAI 호환 경로는 Authorization: Bearer sk-br-v1-… , Messages API는 Anthropic SDK가 보내는 x-api-key 에 같은 BizRouter 키를 넣습니다. 프로바이더별 키는 더 이상 애플리케이션에 두지 않습니다. 자세한 것은 인증 문서 .
2. 코드 변경
SDK별로 바뀌는 부분만 Python (openai) Node.js (openai) Anthropic SDK cURL Vercel AI SDK Vercel AI SDK는 @bizrouter/ai-sdk-provider 패키지를 씁니다. 설치·옵션은 개발 도구 연동 에 있습니다. 지원 파라미터 범위는 각 API 문서( Chat Completions · Responses · Messages )를 확인하십시오.
3. 모델 코드 맞추기
기존 모델 ID → BizRouter 카탈로그 코드 GET /v1/models 가 현재 API 키에서 호출할 수 있는 모델의 기준입니다. 조직·그룹 차단 모델과 키 허용 목록, 차단 프로바이더가 반영된 결과입니다. OpenAI 계열은 openai/ 접두어가 붙은 코드로, 오픈웨이트 모델은 glm-5.3-flash 처럼 짧은 코드로 등록돼 있습니다. 모델 목록 에서 검색하십시오. 같은 모델을 여러 프로바이더가 제공하면 BizRouter가 프로바이더를 고릅니다. 특정 프로바이더로 고정해야 하면 고객지원(support@bizrouter.ai)에 요청하십시오. 모델을 고정하지 않고 요청마다 고르게 하려면 스마트 라우팅 ( bizrouter/route )을 씁니다.
4. 단계적으로 옮기기
운영 트래픽으로 검증한 뒤 켭니다
4. 단계적으로 옮기기 · BYOK로 시작
기존 프로바이더 계약 키를 콘솔에 등록(암호화 보관)하면 계약·단가는 그대로 두고 통제·감사·한도만 BizRouter로 옮길 수 있습니다. 프로바이더 요금은 BizRouter가 청구하지 않고, 계약에 BYOK 이용료가 있으면 그 금액만 붙습니다.
4. 단계적으로 옮기기 · 서비스 하나부터
영향이 작은 서비스의 base_url 과 키를 바꾸고 감사 로그·통계에서 요금과 지연을 확인합니다.
4. 단계적으로 옮기기 · 그룹 단위로 확장
계열사·부서마다 그룹을 만들어 그룹 관리자에게 넘기고, 전사 정책과 배정을 걸어 둡니다.
4. 단계적으로 옮기기 · 키 교체
BYOK를 유지할지, BizRouter 종량제로 옮길지 프로바이더별로 정합니다. 둘을 섞어 쓸 수 있습니다. 스마트 라우팅은 「미리보기」로 고정 모델로 옮긴 뒤 자동 선택을 켜고 싶으면 먼저 미리보기 모드로 두십시오. 응답은 기존 모델이 만들고 자동 선택 결과는 로그에만 남아, 운영 트래픽으로 검증한 뒤 실제 라우팅으로 바꿀 수 있습니다.
5. 콘솔 설정 체크리스트
코드 밖에서 정하는 것들 영역 할 일 전사·그룹 구조와 배정은 엔터프라이즈 조직 관리 , 로그·마스킹·프로바이더 데이터 처리는 데이터 처리 정책 , 장애 대응은 장애 대비 폴백 을 보십시오.
6. 자주 걸리는 것
403 model_blacklisted / provider_blocked — 조직 또는 그룹 정책이 막은 모델·프로바이더입니다. 관리자가 정책을 바꾸거나 다른 모델을 쓰십시오. 403 api_key_model_not_allowed — 키의 허용 모델 밖입니다. 403 *_limit_exceeded — 조직·키·구성원 어느 층의 상한에 닿았습니다. 코드로 어느 층인지 알 수 있습니다. 400 forbidden_content — 금칙어 또는 Corepin 유해 발화 필터에 걸렸습니다. 고정 egress IP — 키에 IP 허용 목록을 걸었다면 배포 환경의 나가는 IP를 등록해야 합니다. 전체 오류 코드는 오류 처리 에 있습니다.
OpenAI Chat Completions https://api.openai.com/v1 https://api.bizrouter.ai/v1 OpenAI Responses API https://api.openai.com/v1 https://api.bizrouter.ai/v1 OpenAI Embeddings · Audio · Images https://api.openai.com/v1 https://api.bizrouter.ai/v1 Anthropic Messages API(SDK) https://api.anthropic.com https://api.bizrouter.ai Claude Code · Agent SDK(ANTHROPIC_BASE_URL) https://api.anthropic.com https://api.bizrouter.ai/claude Gemini · Grok · Perplexity · Upstage · Z.ai · DeepSeek 각 개발사 API https://api.bizrouter.ai/v1 (OpenAI 호환 형식으로 통일) 조직·구성원 최고 관리자 계정을 만들고, 계열사·부서마다 그룹을 추가해 그룹 관리자를 초대합니다. 구성원은 소속(전사 직속 또는 그룹)을 골라 초대합니다. 모델 정책 허용할 모델과 프로바이더를 정합니다. 전사 차단 모델·차단 프로바이더로 「국내 추론 모델만」 같은 정책을 걸 수 있습니다. 예산·호출량 그룹 월 상한 또는 크레딧 이관, 분당 요청 한도, API 키 한도, 구성원 월 한도를 정합니다. 보안 개인정보 마스킹·금칙어·Corepin 필터를 정하고, 전사 보안 정책 강제를 켜서 그룹이 끄지 못하게 합니다. 콘솔 IP 허용 목록도 검토합니다. 키 발급 그룹 관리자가 용도별 API 키를 발급하고 IP 허용 목록·허용 모델·한도를 키에 붙입니다. 로그 정책 감사 로그 저장 여부(끄면 본문 저장이 꺼집니다)와 파일 업로드 허용 여부를 조직 단위로 정합니다. 폴백 장애 대비 폴백 정책(대체 모델·트리거·지연 임계값)을 정하고 모든 그룹에 적용합니다. 정산 연동 사용량 조회 API 키를 발급해 사내 정산·모니터링 시스템에 연결합니다.