Skip to main content
BYOK는 현재 개발 중입니다. 베타 참여를 위해 support@arouter.ai로 문의하세요.
Bring Your Own Key(BYOK)를 사용하면 ARouter에 자신의 제공업체 API 키를 등록할 수 있습니다. 등록된 키가 있는 제공업체로 요청이 라우팅될 때, ARouter는 공유 키 풀 대신 귀하의 키를 사용합니다. 장점:
  • 마진 없음 — 제공업체 정가로 직접 지불, 토큰 비용 마진 없음
  • 자체 할당량 — 요청이 ARouter의 공유 풀이 아닌 귀하의 제공업체 요금 제한에 카운트
  • 자체 데이터 정책 — 기존 제공업체 계약 및 데이터 조건 적용
  • 통합 게이트웨이 — ARouter의 라우팅, 폴백, 관찰 가능성을 상위에서 계속 활용

BYOK 작동 방식

  1. ARouter 대시보드에서 제공업체 API 키 등록
  2. ARouter가 해당 제공업체로 요청을 라우팅할 때 귀하의 키로 대체
  3. 토큰 비용은 계정에 청구되지 않음(ARouter 서비스 요금만, 해당하는 경우)
  4. 응답에 usage.is_byok: true 반환

키 등록

ARouter 대시보드에서 제공업체 키를 추가합니다. 지원되는 제공업체 및 키 형식:

BYOK와 제공업체 순서 결합

BYOK와 provider.order를 결합하여 키가 언제 사용될지 제어합니다:
OpenAI가 순서 목록에 있고 OpenAI BYOK 키가 등록된 경우, ARouter는 해당 제공업체에 귀하의 키를 자동으로 사용합니다.

부분 BYOK

일부 제공업체에는 키를 등록하고 나머지는 ARouter의 공유 풀을 사용할 수 있습니다:
Anthropic BYOK 키가 있으면 귀하의 키로 Anthropic을 먼저 시도합니다. AWS Bedrock 키가 있으면 다음에 시도합니다. 그렇지 않으면 ARouter가 공유 풀로 폴백합니다.

Azure OpenAI

Azure OpenAI 엔드포인트와 키를 등록합니다:
그런 다음 라우팅합니다:

AWS Bedrock

두 가지 인증 옵션: 옵션 1: Bedrock API 키(권장)
옵션 2: AWS 자격 증명

Google Vertex AI


BYOK 요청 식별

귀하의 키가 사용된 경우 응답의 usage 객체에 is_byok: true가 포함됩니다:
is_byok: true인 경우 usage.cost는 귀하의 직접 제공업체 비용(ARouter 마진 없음)을 반영합니다.

키 우선순위 및 폴백


BYOK 문제 디버깅

대시보드의 활동 페이지에서 각 요청에 사용된 키를 확인하세요. 일반적인 오류: