BizRouter 비즈라우터

허용 모델 지정

X-BizRouter-Route-Allowed-Models 헤더로 스마트 라우팅이 이번 요청에서 고를 수 있는 모델을 좁힙니다. 예를 들어 고객사마다 계약한 모델만 쓰게 하거나, 데이터가 국내에서만 처리되는 모델로 제한할 때 정책을 따로 만들지 않고 요청마다 지정합니다.

적용 범위

스마트 라우팅 요청에만 적용됩니다 모델을 bizrouter/route 또는 bizrouter/route/<slug> 로 보낸 요청에만 적용합니다. 모델 코드를 직접 지정한 요청에서는 이 헤더를 읽지 않으며, 형식이 잘못되어도 오류가 나지 않습니다. 적용 엔드포인트: POST /v1/chat/completions ( /ai-sdk/chat/completions 포함), POST /v1/responses , POST /v1/messages ( /claude/v1/messages 포함). /v1/messages/count_tokens 는 이 헤더를 읽지 않습니다. 헤더는 모델 제공사로 전달되지 않습니다.

헤더 형식

항목 규칙

다른 제한과 함께 적용되는 방식

목록은 후보를 좁히기만 하고 넓히지 않습니다 스마트 라우팅은 Route 정책의 모델 풀에서 출발해 조직의 모델 접근 정책(차단 모델·차단 프로바이더), API 키의 허용 모델, 요청이 필요로 하는 기능(이미지·오디오 입력, 도구 호출 등)을 차례로 적용해 후보를 고릅니다. 이 헤더의 목록은 그 결과와 겹치는 모델만 남깁니다. 정책 풀에 없거나 조직에서 막은 모델은 목록에 넣어도 선택되지 않습니다. Route 정책의 폴백 모델도 목록 안에 있는 모델만 씁니다. 고정 모드 Route에서 기본 모델이 목록 밖이면, 정책의 폴백 모델 가운데 목록 안에 있는 첫 모델을 씁니다. 추천만 받는 dry-run Route에서 기본 모델이 목록 밖이면 요청이 실패합니다. 실제로 호출할 모델이 없기 때문입니다. Responses API의 스마트 라우팅은 OpenAI 모델만 후보로 삼습니다. 목록에 OpenAI 모델이 없으면 /v1/responses 에서는 고를 모델이 없어 실패합니다.

요청 예시

cURL Python Node.js Chat Completions와 Messages 응답의 x-bizrouter-routed-model 헤더로 실제로 고른 모델을 확인합니다. Responses API는 이 헤더를 붙이지 않습니다. 다른 응답 헤더는 요청·응답 헤더 에 있습니다.

오류

요청을 보내기 전에 검사합니다 두 오류 모두 모델을 호출하기 전에 나므로 과금되지 않습니다. 어떤 후보가 왜 빠졌는지는 응답 본문에 담기지 않으며, 콘솔의 라우팅 분석에서 확인합니다. Route 정책 설정은 스마트 라우팅 에 있습니다.

구분 쉼표(,)로 나눈 모델 코드 목록입니다. 각 항목의 앞뒤 공백은 지우고, 빈 항목은 건너뜁니다. 일치 방식 GET /v1/models의 모델 코드와 대소문자까지 정확히 같아야 합니다. 카탈로그에 없는 코드는 오류 없이 어떤 모델과도 맞지 않는 항목으로 처리합니다. 허용 문자 영문 대소문자, 숫자, 그리고 . _ : / - 입니다. 항목 안에 공백이 있으면 형식 오류입니다. 개수 최대 200개입니다. 중복된 코드도 개수에 포함합니다. 길이 헤더 전체가 8,192자 이하여야 합니다. 같은 헤더를 여러 줄로 보내면 이어 붙여 하나로 봅니다. 비어 있을 때 헤더가 없거나 항목이 하나도 없으면(예: 빈 문자열) 아무것도 좁히지 않습니다. 400 invalid_route_allowed_models 헤더 형식이 잘못되었습니다. 메시지가 허용 문자, 개수, 길이 중 무엇이 문제인지 알려 줍니다. 400 smart_routing_resolution_failed 목록과 겹치는 후보가 하나도 없어 고를 모델이 없습니다.

주식회사 AI3 | 서울 강남구 영동대로85길 34 | support@bizrouter.ai