recordings

Upload a recording for analysis

Uploads a Base64-encoded audio file. Analysis processing is triggered on a successful upload and may take up to five minutes to complete. Requires an active subscription with available credits; requests are rejected once the balance is exhausted or the subscription is suspended.

Minimum audio requirements:

  • Format: WAV, MP3, MP4, or OGG
  • Sample rate: 8,000 Hz
  • Bit rate: 32,000 bps
  • Channels: 1 (mono)
  • Duration: 30 seconds of speech
  • Maximum file size: 50 MB
post/recordings

Request

  • Base URL: https://api.virtuosis.ai/v1.3
  • URL: https://api.virtuosis.ai/v1.3/recordings
  • Auth: HTTP bearer

Request body

account_idstring uuid required

The ID of the account submitting the recording.

recorded_atstring date-time required

ISO 8601 timestamp of when the recording began.

analysisAnalysisType[] required

Analysis types to run. Must contain at least one type.

audiostring required

Base64-encoded audio file.

isolate_oldest_speakerboolean

When true, the clip is diarised and only the audio of the speaker estimated to be oldest is kept and analysed. Speaker age is estimated from the audio and carries a multi-year error bar, so speakers close in age may not be separated reliably. The retained speaker's speech must clear the same 30-second minimum the whole clip does, or the upload is rejected with a SpeakerSpeechTooShort error. Recordings longer than 10 minutes are rejected with a RecordingTooLongForIsolation error.

Response

Recording uploaded

recording_idstring uuid required

The recording ID used for fetching analysis results.

account_idstring uuid required

The ID of the account that submitted the recording.

recorded_atstring date-time required

ISO 8601 timestamp of when the recording began.

uploaded_atstring date-time required

ISO 8601 timestamp of when the recording was uploaded.

audio_file_formatstring required

Detected audio file format.

audio_size_bytesinteger required

Audio file size in bytes. With isolate_oldest_speaker enabled, this describes the retained audio, not the submitted file.

audio_sample_rate_hzinteger required

Audio sample rate in Hz.

audio_bit_rate_bpsinteger required

Audio bit rate in bits per second.

audio_duration_secondsnumber double required

Total audio duration in seconds. With isolate_oldest_speaker enabled, this is the duration of the retained speaker's audio, not of the submitted clip.

speech_duration_secondsnumber double required

Detected speech duration in seconds. With isolate_oldest_speaker enabled, this is the isolated speaker's speech time, not the whole clip's.

Changes

No recorded changes to this operation across all 1 revision of this API.