Upload a recording for analysis

Minimum audio requirements:

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

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: 16,000 Hz - Bit rate: 32,000 bps - Channels: 1 (mono) - Duration: 30 seconds of speech - Maximum file size: 50 MB

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

account_idstringRequiredformat: "uuid"

The ID of the account submitting the recording.

recorded_atdatetimeRequired

ISO 8601 timestamp of when the recording began.

analysislist of enumsRequired

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

audiostringRequired

Base64-encoded audio file.

Response

Recording uploaded

recording_idstringformat: "uuid"

The recording ID used for fetching analysis results.

account_idstringformat: "uuid"

The ID of the account that submitted the recording.

recorded_atdatetime

ISO 8601 timestamp of when the recording began.

uploaded_atdatetime

ISO 8601 timestamp of when the recording was uploaded.

audio_file_formatstring

Detected audio file format.

audio_size_bytesinteger

Audio file size in bytes.

audio_sample_rate_hzinteger

Audio sample rate in Hz.

audio_bit_rate_bpsinteger

Audio bit rate in bits per second.

audio_duration_secondsdouble

Total audio duration in seconds.

speech_duration_secondsdouble

Detected speech duration in seconds.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

413

Content Too Large Error

500

Internal Server Error

$	curl -X POST https://api.virtuosis.ai/v1.3/recordings \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"account_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
>	"recorded_at": "2024-01-15T09:30:00Z",
>	"analysis": [
>	"wellbeing"
>	],
>	"audio": "UklGRiQAAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YQAAAAA="
>	}'

1	{
2	"recording_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
3	"account_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
4	"recorded_at": "2024-01-15T09:30:00Z",
5	"uploaded_at": "2024-01-15T09:35:00Z",
6	"audio_file_format": "wav",
7	"audio_size_bytes": 480000,
8	"audio_sample_rate_hz": 16000,
9	"audio_bit_rate_bps": 32000,
10	"audio_duration_seconds": 30,
11	"speech_duration_seconds": 28.5
12	}