deepgram-go-audio-intelligence

name	deepgram-go-audio-intelligence
description	Use when writing or reviewing Go code in this repo that applies summaries, topics, intents, sentiment, language detection, diarization, redaction, or entity extraction to audio inputs through Listen v1 REST. Route plain transcription to deepgram-go-speech-to-text and plain-text Read requests to deepgram-go-text-intelligence.
metadata	{"author":"deepgram"}

Using Deepgram Audio Intelligence from the Go SDK

When to use this product

Use this skill for /v1/listen REST requests that combine transcription with analytics overlays.

• summaries
• topics
• intents
• sentiments
• entity extraction
• language detection
• diarization and redaction where supported

Use a different skill when:

• you only need transcription (deepgram-go-speech-to-text)
• your input is already text (deepgram-go-text-intelligence)

Authentication

Set DEEPGRAM_API_KEY before creating the listen REST client.

export DEEPGRAM_API_KEY="your_api_key"

Quick start

package main

import (
	"context"
	"fmt"
	"log"

	api "github.com/deepgram/deepgram-go-sdk/v3/pkg/api/listen/v1/rest"
	listen "github.com/deepgram/deepgram-go-sdk/v3/pkg/client/listen"
	interfaces "github.com/deepgram/deepgram-go-sdk/v3/pkg/client/interfaces"
)

func main() {
	if err := run(); err != nil {
		log.Fatal(err)
	}
}

func run() error {
	ctx := context.Background()

	client := listen.NewRESTWithDefaults()
	dg := api.New(client)

	resp, err := dg.FromURL(
		ctx,
		"https://dpgr.am/spacewalk.wav",
		&interfaces.PreRecordedTranscriptionOptions{
			Model:     "nova-3",
			Summarize: "v2",
			Topics:    true,
			Sentiment: true,
		},
	)
	if err != nil {
		return err
	}

	if resp.Results.Summary != nil {
		fmt.Println(resp.Results.Summary.Result)
	}
	return nil
}

Key parameters

• analytics live on interfaces.PreRecordedTranscriptionOptions
  • Summarize (for example, "v2")
  • Topics
  • Intents
  • Sentiment
  • DetectLanguage
  • DetectEntities
  • Diarize
  • DiarizeModel
  • Redact
• response payloads are in pkg/api/listen/v1/rest/interfaces/types.go
  • Sentiments
  • Topics
  • Intents
  • Entities
  • SummaryV2
• this SDK is REST-first for audio intelligence; the live WS option struct does not expose the same analytics surface

API reference (layered)

1. In-repo reference
   • README.md
   • docs.go
   • pkg/client/listen/v1/rest/client.go
   • pkg/client/interfaces/v1/types-prerecorded.go
   • pkg/client/interfaces/v1/types-stream.go
   • pkg/api/listen/v1/rest/interfaces/types.go
2. OpenAPI
   • https://developers.deepgram.com/openapi.yaml
3. AsyncAPI
   • https://developers.deepgram.com/asyncapi.yaml
4. Context7
   • /llmstxt/developers_deepgram_llms_txt
5. Product docs
   • https://developers.deepgram.com/docs/stt-intelligence-feature-overview
   • https://developers.deepgram.com/docs/summarization
   • https://developers.deepgram.com/docs/topic-detection
   • https://developers.deepgram.com/docs/intent-recognition
   • https://developers.deepgram.com/docs/sentiment-analysis
   • https://developers.deepgram.com/docs/language-detection
   • https://developers.deepgram.com/docs/redaction
   • https://developers.deepgram.com/docs/diarization

Gotchas

1. In this SDK snapshot, audio intelligence is effectively a prerecorded REST feature set.
2. LiveTranscriptionOptions does not expose the same summarize/topic/intent/sentiment/entity surface.
3. REST helpers live on pkg/api/listen/v1/rest; start from api.New(listen.NewRESTWithDefaults()), then layer analytics flags onto PreRecordedTranscriptionOptions.

Example files in this repo

• examples/speech-to-text/rest/summary/main.go
• examples/speech-to-text/rest/sentiment/main.go
• examples/speech-to-text/rest/topic/main.go
• examples/speech-to-text/rest/intent/main.go

Central product skills

For cross-language Deepgram product knowledge — the consolidated API reference, documentation finder, focused runnable recipes, third-party integration examples, and MCP setup — install the central skills:

npx skills add deepgram/skills

This SDK ships language-idiomatic code skills; deepgram/skills ships cross-language product knowledge (see api, docs, recipes, examples, starters, setup-mcp).

---

Source: deepgram/deepgram-go-sdk — distributed by TomeVault.