Deepgram Hello World

概要

Deepgramの音声テキスト変換機能のコア機能を実演する最小限の動作例です。

前提条件

• deepgram-install-auth セットアップの完了
• 有効なAPI認証情報の設定
• トランスクリプション用のオーディオファイル(またはURL)

手順

ステップ1: エントリファイルを作成する

Hello Worldの例のための新しいファイルを作成します。

ステップ2: クライアントをインポートして初期化する

import { createClient } from '@deepgram/sdk';

const deepgram = createClient(process.env.DEEPGRAM_API_KEY);

ステップ3: URLからオーディオをトランスクリプトする

async function transcribe() {
  const { result, error } = await deepgram.listen.prerecorded.transcribeUrl(
    { url: 'https://static.deepgram.com/examples/nasa-podcast.wav' },
    { model: 'nova-2', smart_format: true }
  );

  if (error) throw error;
  console.log(result.results.channels[0].alternatives[0].transcript);
}

transcribe();

出力

• Deepgramクライアント初期化を含む動作するコードファイル
• トランスクリプション応答の成功
• トランスクリプトされたテキストを表示するコンソール出力

エラーハンドリング

エラー	原因	解決方法
Import Error	SDKがインストールされていない	npm list @deepgram/sdk で確認してください
Auth Error	認証情報が無効である	環境変数が設定されていることを確認してください
Audio Format Error	サポートされていない形式である	WAV、MP3、FLAC、またはOGGを使用してください
URL Not Accessible	オーディオをフェッチできない	URLが公開アクセス可能であることを確認してください

例

TypeScript - URLからトランスクリプトする

import { createClient } from '@deepgram/sdk';

const deepgram = createClient(process.env.DEEPGRAM_API_KEY);

async function main() {
  const { result, error } = await deepgram.listen.prerecorded.transcribeUrl(
    { url: 'https://static.deepgram.com/examples/nasa-podcast.wav' },
    { model: 'nova-2', smart_format: true }
  );

  if (error) throw error;
  console.log('Transcript:', result.results.channels[0].alternatives[0].transcript);
}

main().catch(console.error);

TypeScript - ローカルファイルをトランスクリプトする

import { createClient } from '@deepgram/sdk';
import { readFileSync } from 'fs';

const deepgram = createClient(process.env.DEEPGRAM_API_KEY);

async function transcribeFile(filePath: string) {
  const audio = readFileSync(filePath);

  const { result, error } = await deepgram.listen.prerecorded.transcribeFile(
    audio,
    { model: 'nova-2', smart_format: true, mimetype: 'audio/wav' }
  );

  if (error) throw error;
  console.log('Transcript:', result.results.channels[0].alternatives[0].transcript);
}

transcribeFile('./audio.wav');

Pythonの例

from deepgram import DeepgramClient, PrerecordedOptions
import os

deepgram = DeepgramClient(os.environ.get('DEEPGRAM_API_KEY'))

options = PrerecordedOptions(
    model="nova-2",
    smart_format=True,
)

url = {"url": "https://static.deepgram.com/examples/nasa-podcast.wav"}
response = deepgram.listen.rest.v("1").transcribe_url(url, options)

print(response.results.channels[0].alternatives[0].transcript)

リソース

• Deepgram Getting Started
• Deepgram API Reference
• Deepgram Models

次のステップ

開発ワークフロー設定については、deepgram-local-dev-loop に進んでください。