examples について
サードパーティのプラットフォームやフレームワークで Deepgram を利用する開発者向けの統合例です。番号付きの各例は単独で実行でき、音声認識と音声合成の組み込み方を示します。
主な機能
- 01単独で実行できる統合例
- 02エコシステム別のサンプル分類
- 03音声テキスト化の統合パターン
- 04Aura のテキスト音声変換例
- 05関連する Deepgram スキルの案内
活用シーン
- 01Deepgram と電話サービスの連携
- 02チャットや会議アプリへの文字起こし追加
- 03Web・モバイルフレームワークでの Deepgram 利用
- 04音声 AI フレームワークとの統合
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ deepgram/ skills --skill examplesインストール後、Claude Code で/examplesを入力して読み込まれたか確認します。
詳細
Deepgram の使用例
Deepgram を一般的なプラットフォーム、フレームワーク、エコシステムで使用する方法を示す、実際に動作する例です。
使用例を選ぶ場面
- Deepgram を特定のサードパーティサービス(テレフォニー、動画、LLM フレームワーク、ボット、クラウドプラットフォーム)と統合する場合
- SDK レベルのコードだけでなく、統合全体を実行できるデモを確認したい場合
- 実際のアーキテクチャに Deepgram を組み込む方法を確認したい場合
次の場合は別のスキルを使用してください:
- 最小限の機能スニペット(1 つの製品、1 つの言語、50 行未満)が必要 →
recipesスキル - サードパーティサービスを使わずに拡張できる、シンプルなスターターアプリが必要 →
startersスキル - 生の API コントラクトが必要 →
apiスキル
使用例を参照する
リポジトリ:https://github.com/deepgram/examples
各使用例には番号(010、020、…)が付いており、それぞれが独立した統合になっています。
カテゴリ一覧
| カテゴリ | 統合先 | 一般的な STT の選択肢 |
|---|---|---|
| テレフォニー | Twilio、Vonage、SignalWire、Telnyx、Plivo、Daily.co、Asterisk/FreeSWITCH | 通話の文字起こしには Nova live(/v1/listen)、AI エージェントの通話には Flux STT(/v2/listen) |
| 音声 AI フレームワーク | LiveKit Agents、Pipecat、OpenAI Agents SDK、CrewAI | ターン検出機能が組み込まれた Flux STT(/v2/listen)、またはパイプライン全体を処理する Voice Agent(/v1/agent/converse) |
| チャットプラットフォーム | Discord、Slack、Telegram | 添付ファイルには Nova prerecorded(/v1/listen) |
| Web フレームワーク | Next.js、Nuxt、Django、SvelteKit、NestJS、Express + React、FastAPI、Spring Boot、Gin | 字幕には Nova live(/v1/listen)、バッチ処理には Nova prerecorded |
| モバイル/デスクトップ | Expo、Flutter、Swift iOS、Kotlin Android、Tauri、Electron | Nova live(/v1/listen)。アプリが音声エージェントの場合は Flux STT(/v2/listen) |
| クラウド/サーバーレス | AWS Lambda、Cloudflare Workers | リクエスト/レスポンスに最適な Nova prerecorded(/v1/listen) |
| 会議プラットフォーム | Zoom、Riverside.fm、Webex(録画)、Jitsi、Microsoft Teams(ライブ会議) | 録画には Nova prerecorded(/v1/listen)、Jitsi ブリッジと Teams ボットには Nova live(/v1/listen) |
| ブラウザー/バンドラー不要 | Vanilla JavaScript | ブラウザーで @deepgram/sdk を使う Nova live(/v1/listen) |
| LLM フレームワーク | LangChain、LlamaIndex、Vercel AI SDK、Haystack、Semantic Kernel | ストリーミングとバッチ処理のどちらを使うかに応じて Nova または Flux STT |
| ローコード/自動化 | n8n コミュニティノード | イベント駆動型の文字起こしには Nova(/v1/listen) |
| 放送 | OBS Studio(ネイティブ C プラグイン) | 画面上の字幕には Nova live(/v1/listen) |
| インフラストラクチャ | Deepgram API プロキシサーバー(520-node-deepgram-proxy、521-deepgram-proxy-python-uv)、Silero VAD セグメンテーション(530-silero-vad-speech-segmentation-python)、Voice Agent 用の複数プロバイダー対応 LLM プロキシ(530-voice-agent-multi-provider-proxy-python。番号 530 を共有するディレクトリが 2 つあります) | プロキシは Nova prerecorded、Nova live、Aura TTS を転送します。Silero VAD は検出した音声セグメントをそれぞれ Nova prerecorded に送信します。Voice Agent プロキシはエージェントの think.endpoint.url として使用し、STT と TTS はエージェント側で処理します |
上の列は、各統合における STT の部分です。TTS については、現在これらの使用例で使われているのは Aura(/v1/speak)です。テレフォニーや音声 AI フレームワークなど、特に適したカテゴリでも、リポジトリ内に Flux TTS(/v2/speak)を扱う例はまだありません。Flux TTS をこれらのプラットフォームのいずれかに組み込む場合は、統合例からトランスポートと認証の処理を、api スキルから Flux TTS のコントラクトを参照してください。
関連する SDK スキルをインストールする
統合で特定の Deepgram SDK を使用する場合は、言語に適したパターンを学ぶために、その SDK のスキルをインストールしてください。
npx skills add deepgram/deepgram-python-sdk # Python
npx skills add deepgram/deepgram-js-sdk # Node.js / TypeScript
npx skills add deepgram/deepgram-java-sdk # Java
npx skills add deepgram/deepgram-go-sdk # Go
npx skills add deepgram/deepgram-rust-sdk # Rust
npx skills add deepgram/deepgram-dotnet-sdk # C# / .NET
Swift と Kotlin の SDK スキルは、各リポジトリが非公開で npx skills add からアクセスできないため、ここには記載していません。ブラウザー関連の作業では browser-agent スキルを開いてください。npm で公開されている 4 つの Browser Agent SDK パッケージ(@deepgram/agents、@deepgram/react、@deepgram/ui、@deepgram/agents-widget)について説明しています。
関連するDeepgramスキル
api— REST APIとWebSocket APIをまとめたリファレンスrecipes— 特定の機能に絞ったスニペット(1つの機能、1つの言語)starters— サードパーティとの連携がないスターターアプリdocs— ドキュメント検索setup-mcp— Deepgram MCP サーバーのインストール