VoiceRecording interface

Package:

@azure/ai-projects

Metadata for the merged, whole-call stereo recording of a voice conversation (user audio on the left channel, agent audio on the right). Built once from the per-turn segments after the session ends and durably cached. The common metadata (format, sample rate, channels, channel layout, duration) is returned for both Foundry-managed and bring-your-own-storage (BYOS) recordings. For BYOS the response also includes blob_uri, the URI of the recording in the customer's own storage (no SAS token), which the customer downloads using their own storage credentials. For Foundry-managed storage blob_uri is absent and the bytes are streamed via the /audio/content route instead.

Properties

blob_uri	For bring-your-own-storage (BYOS) recordings only: the URI of the recording in the customer's own storage, without a SAS token. The customer downloads it using their own storage credentials. Absent for Foundry-managed storage, where the bytes are streamed via the /audio/content route instead.
channels	The number of audio channels. The merged recording is stereo (2).
channel_layout	The role assigned to each stereo channel.
conversation_id	The id of the conversation this recording belongs to.
duration_ms	The total duration of the recording.
format	The container format of the recording.
sample_rate	The sample rate of the recording in Hz, e.g. 24000.

Property Details

blob_uri

For bring-your-own-storage (BYOS) recordings only: the URI of the recording in the customer's own storage, without a SAS token. The customer downloads it using their own storage credentials. Absent for Foundry-managed storage, where the bytes are streamed via the /audio/content route instead.

blob_uri?: string

Property Value

string

channels

The number of audio channels. The merged recording is stereo (2).

channels: number

Property Value

number

channel_layout

The role assigned to each stereo channel.

channel_layout: VoiceRecordingChannelLayout

Property Value

VoiceRecordingChannelLayout

conversation_id

The id of the conversation this recording belongs to.

conversation_id: string

Property Value

string

duration_ms

The total duration of the recording.

duration_ms: number

Property Value

number

format

The container format of the recording.

format: "wav"

Property Value

"wav"

sample_rate

The sample rate of the recording in Hz, e.g. 24000.

sample_rate: number

Property Value

number