BizRouter 비즈라우터

오디오 API

BizRouter의 오디오 기능은 실시간 대화, REST 음성 대화, 음성 인식, 음성 합성의 네 가지 흐름으로 나뉩니다. 필요한 입출력과 지연시간에 맞춰 엔드포인트와 모델을 함께 선택해야 합니다. 오디오 출력 모델을 아무 엔드포인트에서나 호출할 수 있는 것은 아닙니다 모델의 api_type 이 호출할 API를 결정합니다. 예를 들어 gpt-audio 는 Chat Completions, gpt-realtime 은 Realtime WebSocket, gpt-4o-mini-tts 는 Speech API에서 사용합니다.

오디오 API 선택 기준

같은 음성 입출력이라도 호출 방식과 결과가 다릅니다 목적 입력 → 출력 연결 권장 방식 결과 음성 에이전트·전화 상담 음성·텍스트 → 음성·텍스트 WebSocket Realtime API 실시간 이벤트 비동기 음성 질의·음성 답변 음성·텍스트 → 음성·텍스트 HTTP JSON gpt-audio Chat Completion JSON 회의·인터뷰 받아쓰기 오디오 파일 → 텍스트 HTTP multipart Transcriptions API 전사 JSON 안내 음성·내레이션 생성 텍스트 → 오디오 파일 HTTP JSON Speech API 오디오 바이너리

지원 모델과 API 연결

모델 목록은 최신 카탈로그의 list_order 순서로 제공됩니다 모델 계열 api_type 입력 출력 엔드포인트 openai/gpt-realtime-* realtime 텍스트·오디오·이미지 텍스트·오디오 /v1/realtime openai/gpt-live-1 live 텍스트·오디오 텍스트·오디오 /v1/live/sessions openai/gpt-audio-* chat_completions 텍스트·오디오 텍스트·오디오 /v1/chat/completions openai/gpt-transcribe audio_transcription 오디오·텍스트 힌트 텍스트 /v1/audio/transcriptions openai/gpt-live-transcribe realtime_transcription 오디오 텍스트 /v1/realtime (받아쓰기 설정) openai/gpt-realtime-whisper realtime_transcription 오디오 텍스트 /v1/realtime (받아쓰기 설정) OpenAI · Gemini TTS audio_speech 텍스트 오디오 /v1/audio/speech

공통 인증과 모델 조회

HTTP API는 Bearer 키, Realtime은 연결 환경에 맞는 인증을 사용합니다 HTTP 엔드포인트의 기본 URL은 https://api.bizrouter.ai/v1 입니다. Realtime은 wss://api.bizrouter.ai/v1/realtime 을 사용합니다. 모델 탐색에서는 input_modalities , output_modalities , api_type 을 함께 확인해야 합니다.

사용량과 요금 읽기

텍스트·오디오·이미지 토큰은 서로 다른 단가로 계산됩니다 Realtime: 각 response.done 의 사용량을 세션 단위로 누적합니다. gpt-audio: prompt_tokens_details.audio_tokens 와 completion_tokens_details.audio_tokens 을 텍스트 토큰에서 분리해 계산합니다. STT: 응답의 usage.input_token_details 에서 오디오 입력과 텍스트 힌트 사용량을 확인합니다. TTS: 바이너리 응답 헤더의 X-Input-Tokens 와 X-Output-Tokens 으로 사용량을 확인합니다.

실시간 대화 마이크 입력과 음성 응답을 하나의 WebSocket 세션에서 주고받습니다. GET /v1/realtime openai/gpt-realtime-* /docs/realtime 음성 대화 REST 방식의 Chat Completions에서 텍스트와 오디오를 함께 입력·출력합니다. POST /v1/chat/completions openai/gpt-audio-* /docs/audio-chat 음성 인식 녹음 파일을 업로드해 텍스트와 토큰 사용량을 받습니다. POST /v1/audio/transcriptions openai/gpt-4o(-mini)-transcribe /docs/audio-transcription 음성 합성 텍스트를 음성 파일로 변환합니다. OpenAI와 Gemini TTS를 지원합니다. POST /v1/audio/speech OpenAI · Gemini TTS /docs/audio-output

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