개요
ARouter는 플랫폼 크레딧과 직접 보유한 공급자 키 사용(BYOK) 두 가지 모드를 모두 지원합니다. 자체 키를 사용하면 요청이 해당 공급자 계정을 통해 라우팅되며, 통합 API, 장애 전환, 분석, 지출 관리 등 ARouter의 모든 기능을 그대로 이용할 수 있습니다. 공급자 키는 안전하게 암호화되어 저장되며 라우팅 시 자동으로 우선 사용됩니다. 코드 변경은 필요 없습니다. 대시보드에서 키를 추가하기만 하면 기존 ARouter API Key가 그대로 동작합니다.작동 방식
- 설정 → 연동에서 공급자 API 키를 추가합니다.
- ARouter가 해당 공급자에 대해 자동으로 사용자의 키를 사용합니다.
- 키를 사용할 수 없는 경우 플랫폼 키로 대체할 수 있습니다(설정 가능).
- 사용량은 BYOK과 플랫폼으로 별도 추적됩니다.
지원 공급자
ARouter는 다음 인증 유형의 BYOK를 지원합니다:BYOK 키 추가
대시보드
- 설정 → 연동으로 이동합니다.
- 공급자 키 추가를 클릭합니다.
- 공급자와 인증 유형을 선택합니다.
- 키 또는 인증 정보를 입력합니다.
- (선택) 키 테스트를 클릭하여 정상 동작을 확인합니다.
- 저장을 클릭합니다.
고급 옵션
키 추가 시 다음을 설정할 수 있습니다:대체(Fallback) 동작
기본적으로 BYOK 키가 요청 제한이나 오류에 직면하면, ARouter는 플랫폼 키로 원활하게 대체합니다. 키별로 이 동작을 변경할 수 있습니다:
대시보드에서 **“항상 이 키 사용”**을 활성화하면 대체 거부로 설정됩니다.
다중 키
동일 공급자에 여러 BYOK 키를 추가할 수 있습니다. ARouter는 사용 가능한 모든 키에 대해 가중 랜덤 선택을 수행합니다. 가중치 항목으로 트래픽 분배를 조절하세요.BYOK 사용량 추적
BYOK 요청은 사용량 대시보드에서 별도로 추적됩니다:- BYOK 요청 수 — 사용자 키를 사용한 요청 건수
- 예상 BYOK 비용 — 공급자 요금 기준 추정 비용
- 플랫폼 비용 — 플랫폼 키를 사용한 요청 비용
Azure 설정
Azure OpenAI의 경우 키 설정을 JSON 형식으로 입력합니다:AWS Bedrock 설정
AWS Bedrock의 경우 AWS 인증 정보를 입력합니다:Google Vertex AI 설정
Vertex AI의 경우 서비스 계정 인증 정보를 입력합니다:BYOK 문제 해결
BYOK 요청이 실패하는 경우:- 설정 → 연동에서 키 상태를 확인합니다.
- 키를 클릭하여 최근 오류 메시지를 확인합니다.
- 키 테스트 버튼으로 키가 아직 유효한지 확인합니다.
- 사용량 페이지에서 BYOK 관련 오류율을 확인합니다.