recipes

Deepgram レシピ

対応しているすべての言語で、Deepgram SDK の各機能の使い方を示す、エージェントが管理する小さなレシピです。それぞれのレシピは用途を絞った実行可能なコードスニペットであり、完全なアプリではありません。

レシピを使う場面

• 製品と機能は把握していて、最短で動くコードが欲しい場合
• プロジェクトにコピーできる example.py ／ example.js ／ example.go などが欲しい場合
• 「Deepgram SDK で {feature} を呼び出すには？」という質問に対する、言語固有の回答が欲しい場合

次の場合は別のスキルを使ってください：

• Web UI やデプロイ設定などを含む、完全なスターターアプリが欲しい場合 → starters スキル
• サードパーティプラットフォーム（Twilio、LiveKit、Vercel AI SDK、Discord など）との連携が必要な場合 → examples スキル
• API コントラクト全体（パラメーター、レスポンス、メッセージ形式）が必要な場合 → api スキル
• アプリケーションコードではなく、シェルコマンドが必要な場合 → cli スキル

レシピを閲覧する

リポジトリ：https://github.com/deepgram/recipes

対応状況一覧：https://github.com/deepgram/recipes/blob/main/COVERAGE.md

レシピの構成

recipes/{language}/{product}/{version}/{recipe}/
  example.{ext}       # runnable, < 50 lines, reads DEEPGRAM_API_KEY from env
  example_test.{ext}  # runs the example as a subprocess, asserts output
  README.md           # feature explanation, params, sample output, how to run

対象製品

製品	レシピの例
音声テキスト化：Nova（/v1/listen）	26 個のレシピ：transcribe-url、transcribe-file、streaming、streaming-file、punctuate、smart-format、paragraphs、utterances、diarize、multichannel、numerals、measurements、dictation、filler-words、profanity-filter、redact、replace、search、keywords、keyterm、detect-language、detect-entities、summarize、sentiment、topics、intents
音声テキスト化：Flux STT（/v2/listen）	2 個のレシピ。streaming は model=flux-general-en、encoding=linear16、sample_rate=16000 を指定して /v2/listen WebSocket を開き、v1 の中間／最終ペアの代わりに TurnInfo イベント（文字起こし、ターンインデックス、イベントタイプ）を出力します。transcribe-url は、SDK の録音済み音声の文字起こし URL 呼び出しで model=flux-general-en と smart_format を設定します。CLI にあるのは transcribe-url のみです。EOT や eager EOT のしきい値、セッション中の Configure、keyterms に特化したレシピはありません
テキスト読み上げ：Aura（/v1/speak）	generate-audio、stream-audio、websocket-streaming、select-model、select-encoding、bit-rate
Audio Intelligence（/v1/listen）	summarize、sentiment、topics、intents、entities
Voice Agents	connect、custom-llm、custom-tts、function-calling
Text Analysis（/v1/read）	summarize、sentiment、topics、intents

Audio Intelligence と Text Analysis は異なる入力に対して同じ分析を行うため、すでに手元にあるデータに応じて行を選んでください。Audio Intelligence のレシピは /v1/listen に追加するクエリパラメーターであり、入力は音声で、entities もその一つです。Text Analysis のレシピは単一の POST /v1/read であり、入力はテキストです。また、entities のレシピはありません。/v1/read の detect_entities は 400 {"err_code":"INVALID_QUERY_PARAMETER","err_msg":"unknown query parameter: detect_entities"} を返します。前者には audio-intelligence スキル、後者には text-intelligence スキルを参照してください。Text Analysis のレシピは 7 つすべての言語にあります。

Nova は汎用 STT ファミリーです。Flux STT は会話音声や音声エージェント向けに設計されています。どちらも現在サポートされています。選択ガイドについては、api スキルの「Nova vs Flux STT」セクションを参照してください。Flux STT（/v2/listen）と Flux TTS（/v2/speak）は、Flux という名前を共有する別々の製品です。

Flux TTS（/v2/speak）のレシピはまだありません。 上記の TTS レシピが対象とするのは /v1/speak の Aura のみです。レシピリポジトリに text-to-speech/v2 ディレクトリはありません。Flux TTS については、エンドポイントのコントラクトを api スキルの「Aura vs Flux TTS」セクションで確認するか、実行可能なコードを starters スキルの flux-tts アプリ（node、flask、fastapi、django、java）で確認してください。

言語

Python、JavaScript、Go、.NET、Java、Rust、および Deepgram CLI（dg ／ deepctl）。

関連する SDK スキルをインストールする

単一のレシピにとどまらない言語固有のパターン（クイックスタート全体、一般的なパターン、注意点）については、SDK 固有のスキルをインストールしてください。

npx skills add deepgram/deepgram-python-sdk     # Python
npx skills add deepgram/deepgram-js-sdk         # JavaScript / 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 および WebSocket API を統合したリファレンス
• examples — サードパーティープラットフォームとの統合（Twilio、LiveKit、LangChain など）
• starters — 実行可能なスターターアプリ（フレームワーク × 機能のマトリックス）
• docs — ドキュメント検索
• setup-mcp — Deepgram MCP サーバーのインストール