실시간 받아쓰기
사용 가능말하는 즉시 글자가 나타납니다. 여러 언어를 지원하며 언어는 자동으로 감지됩니다.
실시간 받아쓰기
오디오 초 단위로 과금되며 한 번에 1분씩 예약됩니다. 잔액이 부족하거나, 한동안 조용하거나, 시간 한도에 도달하면 세션이 자동으로 끝납니다.
실행 예시녹음된 라이브 세션
언어: 태국어 · 이 도구의 실제 실행 결과입니다. 직접 실행하면 대체됩니다.
말한 내용
전사
- สวัสดีค่ะ ยินดีต้อนรับสู่ร้านกาแฟของเรา วันนี้เรามีเค้กช็อกโกแลตตอบใหม่ๆ ลองชิมดูไหมคะ
다른 음성 도구
각각 고유한 엔드포인트와 가격이 있습니다. 하나만 쓰거나 이어서 쓰세요.
실시간 받아쓰기 API
WebSocket 하나: 마이크 오디오를 보내면 말하는 중의 단어와 완성된 각 문장 및 언어를 받습니다.
https:/ / api.opennan.com/ v1/ realtime/ sttAPI 키 받기
콘솔에서 키를 만드세요. 플레이그라운드와 같은 잔액을 씁니다.
키 만들기첫 요청 보내기
플레이그라운드가 보내는 것과 같은 요청입니다. OPENNAN_KEY에 키를 넣으세요.
const ws = new WebSocket("wss://api.opennan.com/v1/realtime/stt"); ws.binaryType = "arraybuffer"; ws.onopen = () => { ws.send(JSON.stringify({ type: "auth", ticket: session.ticket })); ws.send(JSON.stringify({ "type": "session.config", "language": "auto" })); }; mic.ondata = (pcm16) => ws.send(pcm16); // 16 kHz mono 16-bit PCM, <= 65536 bytes a frame ws.onmessage = (e) => { const msg = JSON.parse(e.data); if (msg.type === "transcript.partial") showDraft(msg.text); if (msg.type === "transcript.final") addLine(msg.sentence_id, msg.text, msg.language); if (msg.type === "session.end") console.log("ended:", msg.reason); }; stop.onclick = () => ws.send(JSON.stringify({ type: "session.end" }));이벤트 읽기
말하는 동안 서버가 JSON 이벤트를 보내며, 음성은 형식 정보가 담긴 base64 오디오 조각으로 옵니다.
- session.started
- 세션이 열렸습니다(가격과 한도 포함)
- transcript.partial
- 아직 말하는 중의 단어
- transcript.final
- 완성된 문장과 그 언어
- usage
- 지금까지의 초와 비용
- error
- 문제 발생(코드와 쉬운 설명 포함)
- session.end
- 종료 이유: 사용자, 잔액, 무음, 시간 한도
오류와 해결 방법
401키가 없거나 틀림
콘솔에서 만든 키를 Authorization: Bearer 헤더로 보내세요.
402잔액 부족
결제 메뉴에서 잔액을 충전한 뒤 같은 호출을 다시 보내세요.
400받을 수 없는 값
error.message에 필드 이름이 나옵니다. 파라미터 표의 값을 쓰세요.
429요청이 너무 많음
몇 초 기다렸다가 다시 시도하고, 429가 반복되면 더 오래 기다리세요.
실시간 받아쓰기: 질문
실시간 받아쓰기 가격은 얼마인가요?
$0.00846/분, 오디오 초 단위로 과금됩니다. 시간은 1분씩 예약되어 사용하는 대로 정산되며, 잔액이 다음 1분을 감당하지 못하면 세션이 깔끔하게 멈춥니다.
어떻게 호출하나요?
WSS https://api.opennan.com/v1/realtime/stt로 WebSocket을 엽니다. 브라우저에서는 5초 안에 키가 담긴 auth 메시지를 첫 메시지로 보내고, 서버에서는 Authorization 헤더를 쓸 수 있습니다. 그다음 세션 설정과 16 kHz 모노 16비트 PCM 오디오를 보냅니다. 키는 절대 URL에 넣지 않습니다.
실패하면 과금되나요?
아니요. 실패한 단계는 과금되지 않으며, 이유를 쉬운 말로 보여 드립니다.
다른 사람의 목소리를 쓸 수 있나요?
아니요. 본인의 목소리만 복제할 수 있으며, 저희가 드리는 동의 문장을 읽은 녹음이 필요합니다. 목소리는 계정 간에 절대 공유되지 않습니다.
AI 에이전트가 쓸 수 있나요?
네, API로 쓸 수 있습니다. 사용법은 https://api.opennan.com/llms.txt를 읽게 하세요.



