Deepgram Nova-3 Stream API

Deepgram Nova-3 Stream 소개

소켓을 통한 실시간 전사, 화자가 말하는 동안 중간 결과를 반환하고, 각 구절이 끝나면 확정된 전사본이 나옵니다.

OpenAI Realtime 프로토콜을 사용하거나 16kHz 모노 16비트 PCM을 이진 프레임으로 보내고 결과 이벤트를 읽을 수 있습니다.

다른 이름 Deepgram-Nova-3-Stream

Deepgram Nova-3 Stream 사양

모델 ID

deepgram-nova-3-stream

개발사

Deepgram

카테고리

전사

출시

-

입력

오디오

출력

텍스트

엔드포인트

WEBSOCKET/v1/realtime

대체 모델 ID

nova-3-streamdeepgram/deepgram-nova-3-stream

Deepgram Nova-3 Stream API 요금

EmpirioLabs 카탈로그의 실시간 종량제 요금입니다. 사용한 만큼만 결제하며 월 최소 요금이 없습니다.

Deepgram Nova-3 Stream API 호출 방법

Deepgram Nova-3 Stream 은(는) HTTP 엔드포인트가 아니라 wss://api.empiriolabs.ai/v1/realtime?model=deepgram-nova-3-stream 의 WebSocket에서 실시간 오디오 스트림을 전사합니다. 모델 ID deepgram-nova-3-stream 로 연결하고 핸드셰이크 시 EmpirioLabs API 키를 Authorization: Bearer 헤더로 보내세요. base64 16비트 PCM 오디오를 추가하면 말하는 도중에도 전사 이벤트를 받을 수 있습니다. 브라우저는 WebSocket에 헤더를 설정할 수 없으므로 이 연결은 서버에서 열고 오디오는 자체 소켓으로 브라우저에 중계하세요. EmpirioLabs 대시보드에서 API 키를 발급받으세요.

import asyncio, json, os, websockets

async def main():
    async with websockets.connect(
        "wss://api.empiriolabs.ai/v1/realtime?model=deepgram-nova-3-stream",
        additional_headers=[
            ("Authorization", f"Bearer {os.environ['EMPIRIOLABS_API_KEY']}"),
        ],
        max_size=None,
    ) as ws:
        print(json.loads(await ws.recv())["type"])  # session.created

        import base64

        # 16-bit PCM microphone audio, base64 encoded, in small chunks.
        for chunk in read_microphone_chunks():
            await ws.send(json.dumps({
                "type": "input_audio_buffer.append",
                "audio": base64.b64encode(chunk).decode(),
            }))

        await ws.send(json.dumps({"type": "input_audio_buffer.commit"}))

        async for raw in ws:
            event = json.loads(raw)
            if event["type"].endswith("input_audio_transcription.delta"):
                # "text" is settled transcript; "stash" is still in progress.
                if event.get("text"):
                    print(event["text"], end="", flush=True)

asyncio.run(main())

Deepgram Nova-3 Stream API 파라미터

EmpirioLabs에서 Deepgram Nova-3 Stream API가 지원하는 요청 파라미터입니다. 필드를 생략하면 기본값이 적용됩니다.

알아두면 좋은 점

wss@api.empiriolabs.ai/v1/realtime?model=deepgram-nova-3-stream에서 웹 소켓을 통해 API 키를 Authorization 헤더에 넣어 실시간 전사를 할 수 있습니다. OpenAI Realtime 프로토콜(OpenAI SDK를 포함)이나 Deepgram의 스트리밍 프로토콜을 사용해 16kHz 모노 16비트 PCM을 바이너리 프레임으로 전송하세요. 연결 URL에 language=를 추가하여 특정 언어를 전사합니다. 청구는 전송된 오디오 분당 단위로 계산됩니다.

Deepgram Nova-3 Stream API: 자주 묻는 질문

Deepgram Nova-3 Stream API 비용은 얼마인가요?

EmpirioLabs에서 Deepgram Nova-3 Stream은(는) 종량제로 청구됩니다: 전사 $0.025 오디오 분당. 이 페이지의 실시간 요금표는 항상 API 청구 금액과 일치합니다.

Deepgram Nova-3 Stream은(는) 어떤 엔드포인트를 사용하나요?

Deepgram Nova-3 Stream은(는) api.empiriolabs.ai의 WEBSOCKET /v1/realtime를 통해 제공되며 표준 Bearer 토큰 인증을 사용합니다.

통합하기 전에 브라우저에서 Deepgram Nova-3 Stream을(를) 사용해 볼 수 있나요?

EmpirioLabs 플레이그라운드 를 열고 Start session 을 누르면 브라우저에서 바로 사용해 볼 수 있습니다. Deepgram Nova-3 Stream 은(는) 요청과 응답이 아니라 WebSocket으로 동작하므로 직접 연동할 때는 실시간 음성 퀵스타트 부터 시작하세요. EmpirioLabs API 키와 모델 ID deepgram-nova-3-stream 로 서버에서 연결한 뒤 오디오를 양방향으로 스트리밍하면 됩니다.

Deepgram Nova-3 Stream API 키는 어떻게 발급받나요?

EmpirioLabs 계정을 만든 다음 대시보드의 API Keys에서 키를 생성하세요. 요금은 종량제 크레딧이라 실행한 요청에 대해서만 결제합니다.