BizRouter 비즈라우터

Veil: 개인정보를 대역으로 바꿔 보내고 답에서 되돌립니다

요청 속 이름·전화번호·주민등록번호 같은 개인정보를 그럴듯한 가짜 값(대역)으로 바꿔 모델에 보내고, 모델의 답에 나온 대역을 원래 값으로 되돌려 돌려줍니다. 모델은 진짜 값을 보지 못하고, 호출한 쪽은 원래 값이 들어간 완성된 답을 받습니다. 스트리밍 답과 도구 호출 인자도 되돌립니다. 사용 사례와 화면 예시는 Veil 소개 페이지 에 있습니다. 마스킹과 다른 점 마스킹은 값을 [NAME] 같은 자리표시로 지웁니다. 모델은 지워진 값을 다시 쓸 수 없으므로 답에도 자리표시가 남고, 메일 발송 같은 도구 호출은 받는 사람을 채우지 못합니다. Veil은 값을 지우지 않고 같은 형식의 다른 값으로 바꾸었다가 답에서 되돌립니다.

BizRouter Veil

동작 방식 · 감지

요청에서 모델이 읽는 글을 메시지 단위로 모아 Corepin 개인정보 감지 모델에 보냅니다. Chat Completions는 messages[].content (문자열과 text 파트), reasoning_content , 도구 호출 인자의 문자열 값을, Messages API는 system , text 블록, tool_result 내용, tool_use.input 의 문자열 값을 읽습니다. 서명이 붙은 thinking 블록, 이미지, 파일은 건드리지 않습니다.

동작 방식 · 대역 만들기

감지한 값마다 같은 형식의 대역을 만듭니다. 대역은 서버 비밀값, 조직, 범주, 원래 값으로 계산해 정하므로 같은 조직의 같은 값은 요청이 바뀌어도 언제나 같은 대역이 됩니다. 그래서 여러 턴 대화와 프롬프트 캐시가 그대로 이어집니다. 대역이 요청 안의 다른 문자열과 겹치면 다른 후보를 씁니다.

동작 방식 · 모델 호출

대역으로 바꾼 요청이 평소의 인증·정책·스마트 라우팅·과금·로그를 그대로 거칩니다. 이 요청에서는 내장 마스킹과 Corepin 마스킹을 건너뜁니다. 대역을 다시 가리면 답에서 되돌릴 수 없기 때문입니다. 유해발화 차단은 그대로 적용됩니다.

동작 방식 · 되돌리기

응답에 나온 대역을 원래 값으로 바꿔 돌려줍니다. 비스트리밍은 응답 본문 전체를, 스트리밍은 텍스트 조각마다 가장 긴 대역 길이만큼 붙잡았다가 바꿔서 내보냅니다. 도구 호출 인자는 호출이 끝날 때 JSON을 풀어 문자열 값을 되돌린 뒤 한 번에 내보냅니다.

켜는 방법

넷 중 하나면 됩니다. Chat Completions와 Messages API에서 스트리밍, 비스트리밍 모두 동작합니다. 방법 예시 비고 본문 필드 "veil": true 범주나 echo를 고르려면 객체로 보냅니다. "on" 도 받습니다. 모델 이름 접미사 openai/gpt-5.6-sol:veil · bizrouter/route:veil Search와 함께 쓸 때는 …:search:veil 순서로 붙입니다. 헤더 X-BizRouter-Veil: on 본문을 고칠 수 없는 도구에서 씁니다. on/off(true/false, 1/0) 밖의 값은 400입니다. 조직 정책 콘솔 보안 정책 → 「개인정보를 찾았을 때」 = 베일 그 조직의 모든 요청에 적용됩니다. 요청에서 끌 수 없습니다. 조직 설정 curl OpenAI SDK Anthropic SDK :veil 접미사 다른 엔드포인트(Responses API, 임베딩, 이미지, 오디오 등)에 본문 필드나 접미사를 보내면 조용히 무시하지 않고 400으로 거절합니다.

본문 필드 veil

true 대신 객체를 보내면 범주와 확인용 출력을 고를 수 있습니다. 필드 타입 설명 categories string[] 바꿀 범주 코드입니다. 범주 표 의 코드만 받고, 모르는 코드는 400으로 거절합니다. 생략하면 조직 설정의 범주를, 조직 설정에도 없으면 기본 범주를 씁니다. echo boolean true면 응답의 bizrouter_veil 에 모델이 실제로 받은 메시지와 되돌리기 전 답을 함께 돌려줍니다. 처음 연동할 때 확인용으로 씁니다. 응답에 원래 값과 대역이 함께 담기므로 운영 로그에 그대로 남기지 않는 것을 권장합니다.

응답

응답 형식은 평소와 같습니다. Veil을 적용하면 응답 헤더 X-BizRouter-Veil: applied; entities=N 과 응답 본문의 bizrouter_veil 이 붙습니다. 필드 설명 echo 를 켜면 bizrouter_veil 에 다음 두 필드가 더 붙습니다. 스트리밍 응답은 가장 긴 대역 길이만큼, 대개 20~40자 늦게 나옵니다. 대역이 조각 경계에 걸쳐 나와도 붙잡았다가 원래 값으로 바꿔 내보내므로 대역 일부가 클라이언트에 새어 나오지 않습니다.

범주

Corepin 개인정보 감지 모델의 19가지 범주입니다. 15가지가 기본으로 켜져 있습니다. 범주 코드 기본 대역을 만드는 법 금액·날짜·회사명·URL을 기본에서 뺀 이유는 답의 정확성입니다. 금액이나 날짜를 바꾸면 모델이 대역으로 계산한 결과가 틀어지고, 그 결과는 되돌릴 수 없습니다. 회사명과 URL은 대부분 개인정보가 아니라 답의 근거입니다. 필요하면 categories 나 조직 설정에서 켭니다. 베일 요청은 조직의 개인정보 마스킹을 건너뜁니다. 그래서 요청에서 범주를 줄여도, 조직이 이미 가리고 있던 범주(Corepin 개인정보 필터의 범주, 일반 필터의 주민등록번호·여권번호)는 언제나 함께 바뀝니다. 조직 기준보다 적게 가릴 수는 없습니다.

대역을 만드는 규칙

이름 : 성의 길이를 지키고, 마지막 글자의 받침 종류(없음, ㄹ, 그 밖)를 원래 이름과 맞춥니다. 그래서 「김민수는」은 「한지호는」, 「최윤정으로」는 「하지안으로」가 되어 은/는, 이/가, 으로/로가 그대로 맞습니다. 로마자 표기가 흔들리지 않는 음절만 씁니다. 숫자형 (전화·계좌·카드·주민·외국인·여권·면허·건강보험·사업자·법인·차량·IP): 자리 수, 구분자, 앞자리(010, 02 등), 마지막 글자를 지키고 나머지를 바꿉니다. 이메일 : 아이디를 바꾸고 회사 도메인은 example.<원래 최상위 도메인> 으로 바꿉니다. 공용 메일 도메인은 그대로 둡니다. 주소 : 시·도, 구·군, 동·읍·면, 로·길 단위로 같은 종류의 다른 지명으로 바꾸고 번지와 호수는 다른 숫자로 바꿉니다. 비밀정보 : 알려진 접두사( sk- , ghp_ , AKIA 등)와 길이, 문자 종류를 지킵니다. 한 번 감지된 값은 대화 전체에서, 감지가 놓친 자리까지 같은 대역으로 바뀝니다. 한글 값은 앞 글자가 한글이 아닐 때(단어 머리)만 바꾸므로 「이상」이 「이상하다」를 건드리지 않습니다.

되돌리는 규칙

숫자형 값은 숫자열로 찾습니다. 모델이 구분자를 바꿔 써도( 010 7315 2846 , 01073152846 , +82 10-7315-2846 ) 원래 번호로 돌아갑니다. 이름은 영문 표기 변형( Han Jiho , Jiho Han , Han Ji-ho )도 원래 이름의 영문 표기로 되돌립니다. 도구 호출 인자는 JSON 문자열 값 단위로 되돌리므로 인자 구조가 깨지지 않습니다. 서명이 붙은 thinking 블록은 그대로 둡니다. 서명이 깨지지 않게 하기 위해서입니다.

실패와 오류

503 : 감지가 시간 안에 끝나지 않거나 실패하면 요청을 모델에 보내지 않습니다. 일반 개인정보 필터는 감지가 실패하면 요청을 그대로 보내지만, Veil을 요청한 경우에는 원문이 나가는 것이 가장 나쁜 결과이므로 반대로 동작합니다. 감지 기능이 전체적으로 꺼져 있을 때도 503입니다. 400 : 지원하지 않는 엔드포인트에서 켰거나, veil 값의 형식이 틀렸거나, 모르는 범주 코드를 보냈을 때입니다. 503을 받으면 같은 요청을 잠시 뒤 다시 보내면 됩니다. Veil 없이 다시 보내면 원래 값이 모델로 나가므로, 자동 재시도에서 Veil을 빼지 않도록 합니다.

요금

감지한 메시지 하나당 Corepin 개인정보 필터 단가(현재 5원)를 받습니다. 대화가 이어질 때 이미 감지한 메시지는 저장해 둔 위치와 종류를 다시 쓰고 요금을 받지 않습니다. 이번 요청에서 새로 감지한 수는 bizrouter_veil.detection.calls 로 확인합니다. 모델 토큰 요금은 평소와 같습니다. 베타 기간에는 사용량만 기록하고, 2026년 12월 1일부터 크레딧에서 차감합니다.

개인정보 처리

모델(해외 AI 회사의 모델 포함)에는 대역만 갑니다. BizRouter 요청 로그에도 대역이 남습니다. BizRouter는 원래 값과 대역을 잇는 치환표를 저장하지 않습니다. 치환표는 요청이 끝나면 게이트웨이 메모리에서 사라집니다. 같은 값이 같은 대역이 되는 것은 계산으로 정하기 때문이며, 치환표를 보관해서가 아닙니다. 감지 결과 캐시에는 위치와 종류만 남고 값은 남지 않습니다. 캐시 키는 메시지 본문의 HMAC입니다. 감지는 Corepin 개인정보 감지 모델이 합니다. Corepin 쪽의 데이터 처리는 데이터 처리 정책 과 하위처리자 목록에서 확인합니다.

한계

모델이 대역에서 새로 만든 값은 되돌릴 수 없습니다. 대역 생년월일로 계산한 나이, 한자나 다른 나라 문자로 옮긴 이름, 「한 대리」처럼 대역의 성만 떼어 쓴 호칭이 그렇습니다. 모델이 대역과 우연히 같은 문자열을 새로 쓰면 그 부분도 원래 값으로 바뀝니다. 대화 어디에서도 감지되지 않은 값은 그대로 모델에 갑니다. 이미지와 파일 속 글자는 바꾸지 않습니다. Responses API와 AI SDK 경로는 아직 지원하지 않습니다(베일을 요청하면 400으로 거절합니다). Claude Code가 보내는 토큰 세기 요청(count_tokens)은 지금처럼 기본 정규식 필터만 거칩니다. 한글 대역은 단어 첫머리에서만 되돌리고, 이름만 따로 쓴 경우는 뒤에 호칭·조사가 붙을 때만 되돌립니다.

Search와 함께 쓰기

아직은 함께 쓸 수 없습니다. Search 는 대화 중간에 데이터 출처의 결과를 덧붙이는데, 베일은 아직 이 결과를 걸러 내지 않습니다. 그래서 Search와 Veil을 함께 요청하면 400 으로 거절합니다. 조직 정책이 베일인 조직에서도 Search 요청은 400입니다.

조직 설정 (관리자)

관리자는 콘솔 설정 → 보안 정책 → Corepin 필터 → 개인정보(PII) 필터 에서 「개인정보를 찾았을 때」를 베일 로 바꿀 수 있습니다. 그러면 그 조직의 Chat Completions와 Messages API 요청이 모두 코드 변경 없이 Veil을 거칩니다. Corepin 필터와 개인정보(PII) 필터가 켜져 있어야 합니다. 마스킹 (기본): 찾은 값을 [NAME] 같은 자리표시로 가려서 보냅니다. 베일 : 찾은 값을 대역으로 바꿔 보내고, 답에서 원래 값으로 되돌립니다. 바꿀 범주는 같은 필터의 범주 선택을 따릅니다. 범주를 따로 고르지 않았다면 마스킹은 모든 범주를, 베일은 위 표의 기본 15가지를 씁니다. 응답의 bizrouter_veil.policy 가 organization 이면 조직 정책으로 켜진 요청입니다.

curl https://api.bizrouter.ai/v1/chat/completions \ -H "Authorization: Bearer $BIZROUTER_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "openai/gpt-5.6-sol", "veil": true, "messages": [ {"role": "user", "content": "김민수 고객님(010-4827-1956)께 보낼 환불 안내 문자 작성. 중복 결제분은 3일 안에 환불."} ] }' from openai import OpenAI client = OpenAI( base_url="https://api.bizrouter.ai/v1", api_key=BIZROUTER_API_KEY, ) completion = client.chat.completions.create( model="openai/gpt-5.6-sol", # 또는 model="openai/gpt-5.6-sol:veil" messages=[{"role": "user", "content": "김민수 고객님(010-4827-1956)께 보낼 환불 안내 문자 작성."}], extra_body={"veil": True}, ) print(completion.choices[0].message.content) # 원래 값이 들어간 답 print(completion.model_extra["bizrouter_veil"]) # 바꾼 값의 수와 종류 import anthropic client = anthropic.Anthropic( base_url="https://api.bizrouter.ai", api_key=BIZROUTER_API_KEY, ) message = client.messages.create( model="anthropic/claude-sonnet-5:veil", # 또는 extra_body={"veil": True} max_tokens=1024, messages=[{"role": "user", "content": "김민수 고객님(010-4827-1956)께 보낼 환불 안내 문자 작성."}], ) print(message.content[0].text) print(message.model_extra["bizrouter_veil"]) # 모델 이름 뒤에 :veil "model": "openai/gpt-5.6-sol:veil" # 스마트 라우팅과 함께 "model": "bizrouter/route:veil" # Search와 함께 (:search 뒤에 :veil) "model": "openai/gpt-5.6-sol:search:veil" # 본문을 고칠 수 없는 도구에서는 헤더로 X-BizRouter-Veil: on { "model": "openai/gpt-5.6-sol", "veil": { "categories": ["private_person", "private_phone", "kr_money"], "echo": true }, "messages": [...] } HTTP/1.1 200 OK X-BizRouter-Veil: applied; entities=2 { "id": "chatcmpl-...", "object": "chat.completion", "model": "gpt-5.6-sol", "choices": [{ "index": 0, "message": { "role": "assistant", "content": "김민수 고객님, 중복 결제로 불편을 드려 죄송합니다. 중복 결제분은 3일 안에 환불됩니다. 처리 결과는 이 번호(010-4827-1956)로 다시 알려 드리겠습니다." }, "finish_reason": "stop" }], "usage": { "prompt_tokens": 61, "completion_tokens": 74, "total_tokens": 135 }, "bizrouter_veil": { "applied": true, "entities": 2, "by_label": { "private_person": 1, "private_phone": 1 }, "restored": 2, "policy": "request", "detection": { "calls": 1, "cached_messages": 0 } } } "bizrouter_veil": { "applied": true, "entities": 2, "by_label": { "private_person": 1, "private_phone": 1 }, "restored": 2, "policy": "request", "detection": { "calls": 1, "cached_messages": 0 }, "sent": [ { "role": "user", "content": "한지호 고객님(010-7315-2846)께 보낼 환불 안내 문자 작성. 중복 결제분은 3일 안에 환불." } ], "model_output": "한지호 고객님, 중복 결제로 불편을 드려 죄송합니다. 중복 결제분은 3일 안에 환불됩니다. 처리 결과는 이 번호(010-7315-2846)로 다시 알려 드리겠습니다." } 자리 수, 구분자, 앞자리, 마지막 글자를 지킨 다른 번호 private_person 이름 성의 길이와 마지막 글자의 받침 종류를 맞춘 다른 이름 private_address 주소 시·도, 구·군, 동·읍·면, 로·길 단위로 같은 종류의 다른 지명. 번지와 호수는 다른 숫자 private_email 이메일 아이디를 바꾸고 회사 도메인은 example.<원래 최상위 도메인>으로. 공용 메일 도메인은 그대로 private_phone 전화번호 account_number 계좌·카드번호 secret 비밀정보(API 키·토큰·비밀번호) 알려진 접두사(sk-, ghp_, AKIA 등)와 길이, 문자 종류를 지킨 다른 값 kr_rrn 주민등록번호 kr_foreigner_id 외국인등록번호 kr_passport 여권번호 kr_driver_license 운전면허번호 kr_health_insurance 건강보험증번호 kr_biz_no 사업자등록번호 kr_corp_no 법인등록번호 kr_vehicle_plate 차량번호 private_ip IP 주소 kr_money 금액 기본 제외. 대역 금액으로 계산한 결과는 되돌릴 수 없습니다 private_date 날짜(생년월일 등) 기본 제외. 대역 날짜로 계산한 나이 같은 값은 되돌릴 수 없습니다 kr_company 회사명·기관명 기본 제외. 대부분 개인정보가 아니라 답의 근거입니다 private_url URL 기본 제외. 대부분 개인정보가 아니라 답의 근거입니다 applied Veil을 적용했으면 true입니다. entities 대역으로 바꾼 값의 수입니다. 같은 값이 여러 번 나와도 하나로 셉니다. by_label 범주별로 바꾼 값의 수입니다. 키는 Corepin 범주 코드입니다. restored 답에서 대역을 원래 값으로 되돌린 횟수입니다. policy request(요청에서 켬) 또는 organization(조직 정책으로 켬)입니다. detection.calls · detection.cached_messages 이번 요청에서 새로 감지한 메시지 수와, 앞서 감지한 결과를 다시 쓴 메시지 수입니다. 요금은 calls 기준입니다. sent echo를 켰을 때만 붙습니다. 모델이 실제로 받은 메시지입니다. model_output echo를 켰을 때만 붙습니다. 원래 값으로 되돌리기 전 모델의 답입니다.

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