Opennan

실시간 받아쓰기

사용 가능

말하는 즉시 글자가 나타납니다. 여러 언어를 지원하며 언어는 자동으로 감지됩니다.

$0.00846/분실패한 단계는 과금되지 않습니다

실시간 받아쓰기

$0.00846/분
말하는 방식
말하는 동안 버튼(또는 스페이스)을 누르고 있다가 놓으면 문장이 마무리됩니다.

오디오 초 단위로 과금되며 한 번에 1분씩 예약됩니다. 잔액이 부족하거나, 한동안 조용하거나, 시간 한도에 도달하면 세션이 자동으로 끝납니다.

준비됨

실행 예시녹음된 라이브 세션

언어: 태국어 · 이 도구의 실제 실행 결과입니다. 직접 실행하면 대체됩니다.

말한 내용

0:00 / 0:00

전사

  1. สวัสดีค่ะ ยินดีต้อนรับสู่ร้านกาแฟของเรา วันนี้เรามีเค้กช็อกโกแลตตอบใหม่ๆ ลองชิมดูไหมคะ

실시간 받아쓰기 API

WebSocket 하나: 마이크 오디오를 보내면 말하는 중의 단어와 완성된 각 문장 및 언어를 받습니다.

WSShttps://api.opennan.com/v1/realtime/stt
  1. API 키 받기

    콘솔에서 키를 만드세요. 플레이그라운드와 같은 잔액을 씁니다.

    키 만들기
  2. 첫 요청 보내기

    플레이그라운드가 보내는 것과 같은 요청입니다. 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" }));
  3. 이벤트 읽기

    말하는 동안 서버가 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를 읽게 하세요.

언어 설정과 추천 코드처럼 사이트에 꼭 필요한 쿠키만 사용합니다. 광고는 없습니다. 페이지 방문 수는 쿠키 없는 분석으로 집계합니다. 자세한 내용은 쿠키 정책 페이지를 참고하세요.