Multichannel

Multichannel transcribes each channel in submitted audio independently.

multichannel boolean. Default: false

When set to true, you will receive separate transcripts for each channel.

Enable Feature

To enable Multichannel, when you call Deepgram’s API, add a multichannel parameter set to true in the query string:

multichannel=true

You can use a maximum of 20 channels.

To transcribe audio from a file on your computer, run the following curl command in a terminal or your favorite API client.

curl \
  --request POST \
  --header 'Authorization: Token YOUR_DEEPGRAM_API_KEY' \
  --header 'Content-Type: audio/mp3' \
  --data-binary @youraudio.mp3 \
  --url 'https://api.deepgram.com/v1/listen?multichannel=true'

🚧

Replace YOUR_DEEPGRAM_API_KEY with your Deepgram API Key.

Analyze Response

ℹ️

For this example, we use an MP3 split stereo audio file that contains the first 10 seconds of a customer call with a florist. If you would like to follow along, you can download it.

When the file is finished processing (often after only a few seconds), you’ll receive a JSON response.

Note that the response structure differs depending on whether audio is submitted to our pre-recorded endpoint or our streaming endpoint.

Pre-Recorded Response

{
	"metadata": {
		...
		"channels": 0
	},
	"results": {
		"channels": [
			{
				"alternatives": []
			}
		]
	}
}

For this response, the channels property under metadata will be set to 2 because our sample audio track has two channels.

Let's look more closely at the channels object under results:

...
"channels":[
  {
    "alternatives":[
      {
        "transcript":"thank you for calling marcus flowers how history i'd be happy to take care of your order may i have your name please",
        "confidence":0.98221713,
        "words":[
          {"word":"thank","start":0.94,"end":1.06,"confidence":0.9963781},
					...
        ]
      }
    ]
  },
  {
    "alternatives":[
      {
        "transcript":"hello i'd like to order flowers and i think you have what i'm looking for",
        "confidence":0.99148595,
        "words":[
          {"word":"hello","start":4.0095854,"end":4.049482,"confidence":0.9823143},
					...
        ]
      }
    ]
  }
]
...

In this response, we see that the channels object contains two sub-objects, one for each channel identified in the audio. Within each channel, each alternative contains multiple objects, each of which includes:

  • transcript: Transcript for the audio being processed.
  • confidence: Floating point value between 0 and 1 that indicates overall transcript reliability. Larger values indicate higher confidence.
  • words: Object containing each word in the transcript, along with its start time and end time (in seconds) from the beginning of the audio stream, and a confidence value.

In the first channel object, notice that the word history has an end time of 3.5, while the word i'd has a start time of 7.93305; this is a considerable gap in audio within this channel. Now, notice that in the second channel object, the first word has a start time of 4.0095854 and the last word has an end time of 7.3209844. This time frame falls directly in the middle of the gap in the first channel object.

This makes sense because our sample audio file is a split stereo file with speakers separated on different channels. We can see that one speaker greets another in the first audio channel, waits for a response from the speaker recorded in the second audio channel, and then responds in the first audio channel.

Streaming Response

{
  "metadata": {
    ...
	},
    "channel_index": [
      0,
      2
    ],
    "channel": {
      "alternatives": []
    }
  }

For this response, the channel_index property will be set to [0, 2] . The second number in the array is the number of channels (in this case, 2). The first number is the channel that the transcript in the message belongs to. In our example, you will see messages with [0, 2] representing transcription of the first channel, and [1, 2] for transcription of the second channel.

Let's look more closely at the results of the stream. Deepgram will send back separate messages for each channel, like so:

{
  "metadata": {
    ...
  },
  "channel_index": [
    0,
    2
  ],
  "duration": 3.58,
  "start": 0,
  "is_final": true,
  "speech_final": true,
  "channel": {
    "alternatives": [
      {
        "transcript": "thank you for calling martha flores how may i assist you",
        "confidence": 0.99853516,
        "words": [
          {
            "word": "thank",
            "start": 0.64,
            "end": 0.79999995,
            "confidence": 0.99853516
          },
          {
            "word": "you",
            "start": 0.79999995,
            "end": 1.04,
            "confidence": 1
          },
          {
            "word": "for",
            "start": 1.04,
            "end": 1.1999999,
            "confidence": 0.9995117
          },
          {
            "word": "calling",
            "start": 1.1999999,
            "end": 1.5999999,
            "confidence": 1
          },
          {
            "word": "martha",
            "start": 1.5999999,
            "end": 2,
            "confidence": 0.97216797
          },
          {
            "word": "flores",
            "start": 2,
            "end": 2.48,
            "confidence": 0.73010254
          },
          {
            "word": "how",
            "start": 2.48,
            "end": 2.6399999,
            "confidence": 0.9926758
          },
          {
            "word": "may",
            "start": 2.6399999,
            "end": 2.8,
            "confidence": 0.99853516
          },
          {
            "word": "i",
            "start": 2.8,
            "end": 2.8799999,
            "confidence": 0.9995117
          },
          {
            "word": "assist",
            "start": 2.8799999,
            "end": 3.1999998,
            "confidence": 1
          },
          {
            "word": "you",
            "start": 3.1999998,
            "end": 3.58,
            "confidence": 0.9963379
          }
        ]
      }
    ]
  }
}

This first message represents the transcription of the first channel. It will be followed by another message representing the transcription of the second channel, marked with channel_index: [1, 2]

{
  "metadata": {
    ...
  },
  "channel_index": [
    1,
    2
  ],
  "duration": 4.43,
  "start": 3.02,
  "is_final": true,
  "speech_final": true,
  "channel": {
    "alternatives": [
      {
        "transcript": "hello i'd like to order flowers and i think you have what i'm looking for",
        "confidence": 0.99902344,
        "words": [
          {
            "word": "hello",
            "start": 3.6599998,
            "end": 4.06,
            "confidence": 0.9436035
          },
          {
            "word": "i'd",
            "start": 4.06,
            "end": 4.3,
            "confidence": 0.99902344
          },
          {
            "word": "like",
            "start": 4.3,
            "end": 4.46,
            "confidence": 0.9995117
          },
          {
            "word": "to",
            "start": 4.46,
            "end": 4.7,
            "confidence": 0.9975586
          },
          {
            "word": "order",
            "start": 4.7,
            "end": 5.02,
            "confidence": 1
          },
          {
            "word": "flowers",
            "start": 5.02,
            "end": 5.5,
            "confidence": 0.8449707
          },
          {
            "word": "and",
            "start": 5.5,
            "end": 5.74,
            "confidence": 0.9995117
          },
          {
            "word": "i",
            "start": 5.74,
            "end": 5.8199997,
            "confidence": 0.99902344
          },
          {
            "word": "think",
            "start": 5.8199997,
            "end": 6.06,
            "confidence": 0.9980469
          },
          {
            "word": "you",
            "start": 6.06,
            "end": 6.22,
            "confidence": 0.9916992
          },
          {
            "word": "have",
            "start": 6.22,
            "end": 6.46,
            "confidence": 0.9995117
          },
          {
            "word": "what",
            "start": 6.46,
            "end": 6.62,
            "confidence": 0.9995117
          },
          {
            "word": "i'm",
            "start": 6.62,
            "end": 6.7799997,
            "confidence": 0.9992676
          },
          {
            "word": "looking",
            "start": 6.7799997,
            "end": 7.18,
            "confidence": 0.9995117
          },
          {
            "word": "for",
            "start": 7.18,
            "end": 7.45,
            "confidence": 0.9416504
          }
        ]
      }
    ]
  }
}