BizRouter 비즈라우터

실시간 대화

말하고 바로 답을 듣는 음성 대화를 WebSocket 하나로 처리합니다. 세션 설정과 이벤트 이름, 파라미터가 OpenAI Realtime API와 완전히 같으므로 기존 코드에서 주소와 키만 바꾸면 그대로 동작합니다. 음성 인식, REST 음성 대화, 음성 합성과의 차이는 오디오 API 에서 먼저 비교할 수 있습니다. 연결 주소 wss://api.bizrouter.ai/v1/realtime?model={모델 코드} 모델 코드는 BizRouter 코드를 그대로 사용합니다. 예를 들면 openai/gpt-realtime-2.1-mini 입니다.

연결하기

서버에서 연결할 때는 API 키를 헤더에 담습니다 Node.js Python 브라우저 브라우저 WebSocket은 헤더를 붙일 수 없으므로 OpenAI와 동일하게 서브프로토콜로 키를 전달합니다. 키가 브라우저에 노출되므로 사내 도구처럼 신뢰할 수 있는 환경에서만 사용해야 합니다. 일반 사용자용 서비스에는 중계 서버를 두는 방식을 권장합니다.

지원 모델

GET /v1/models 에서 api_type 이 realtime 인 모델만 사용할 수 있습니다 모델 컨텍스트 특징 openai/gpt-realtime-2.1 128K 가장 성능이 좋은 음성 모델 openai/gpt-realtime-2.1-mini 128K 같은 계열에서 값이 가장 싼 쪽 openai/gpt-realtime-2 128K 도구 호출이 많은 음성 에이전트용 openai/gpt-realtime-1.5 32K 상담·고객응대용

요금과 세션 한도

음성 토큰은 글자 토큰보다 훨씬 비쌉니다. 같은 모델 안에서도 최대 33배까지 차이가 나므로 글자·음성·이미지를 각각 따로 계산합니다. 요청 하나가 끝날 때마다( response.done ) 실제 사용량으로 정산하며 사용 내역에도 같은 단위로 기록됩니다. 세션 금액 한도 통화가 이어지는 동안 요금이 계속 발생하므로 세션 하나에 사용할 수 있는 금액에 상한을 둡니다. 한도에 도달하면 type: "error" 이벤트로 code: "session_cost_limit_exceeded" 를 보낸 뒤 연결을 닫습니다. 새 세션을 열면 한도가 다시 적용됩니다.

OpenAI와의 차이

이벤트는 그대로 전달됩니다. 클라이언트 이벤트와 서버 이벤트를 변경하지 않고 그대로 전달합니다. 새 필드가 생겨도 중간에서 제거되지 않습니다. 모델 이름만 바꾸어 반환합니다. session.created 와 session.updated 의 session.model 은 BizRouter 모델 코드로 표시됩니다. WebRTC와 SIP은 아직 지원하지 않습니다. 현재는 WebSocket만 지원합니다. 임시 키 발급( client_secrets )은 아직 지원하지 않습니다. 브라우저에서는 위의 서브프로토콜 방식을 사용해야 합니다. 대화 내용은 저장하지 않습니다. 사용량과 요금만 기록하며 음성과 텍스트는 저장하지 않습니다. 받아쓰기는 모델을 지정해야 활성화됩니다. session.audio.input.transcription 을 활성화하면 별도 받아쓰기 모델이 동작합니다. 해당 모델은 통화 모델과 요금이 다르므로 별도로 계산됩니다. 따라서 model 을 반드시 지정해야 합니다. 음성 인식 에 있는 모델 중에서 선택합니다. 모델을 생략하거나 지원하지 않는 모델을 지정하면 해당 설정만 거절하고 오류 이벤트를 보냅니다. 통화는 종료되지 않으므로 모델을 변경해 다시 전송할 수 있습니다. 내용 필터 사내 금지어 차단은 클라이언트가 보내는 텍스트 이벤트에 그대로 적용됩니다. 다만 개인정보 가리기와 유해표현 판정은 음성 스트림을 읽을 수 없어서 이 엔드포인트에서는 동작하지 않습니다. 민감한 내용을 다루는 통화에서는 이 제한을 고려해야 합니다. REST 호출 한 번으로 음성 질의와 음성 답변을 처리하려면 음성 대화 를 사용해야 합니다.

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