Advanced Voice Analysis

Analyzes voice range profile from sustained vowel glissando recording

get/api/calculate-ambitus

Request

  • Base URL: https://platform.vocametrix.com
  • URL: https://platform.vocametrix.com/api/calculate-ambitus
  • Auth: API key in header X-API-Key

Query parameters

svFileIdstring binary required

File ID of the uploaded glissando recording (sustained vowel from low to high pitch)

ageinteger required

Representative age from age group (Child: 8, Adolescent: 15, Adult: 30). Affects pitch tracking parameters and range expectations

gender1 | 2 | 3 required

Patient gender (1=Male, 2=Female). Influences expected range and analysis settings

Response

Successful response

AMBITUS_SEMITONESstring

Voice range in semitones (12 × log₂(F0_max/F0_min))

AMBITUS_OCTAVESstring

Voice range in octaves (semitones ÷ 12)

FREQUENCY_RATIOnumber

Ratio of highest to lowest frequency (F0_max/F0_min)

RANGE_CLASSIFICATIONstring

Age-appropriate range assessment (Excellent/Normal/Reduced/Severely reduced)

F0_MINnumber

Minimum fundamental frequency in Hz

F0_MAXnumber

Maximum fundamental frequency in Hz

F0_MEANnumber

Mean fundamental frequency in Hz

F0_MEDIANnumber

Median fundamental frequency in Hz

PATIENT_AGEstring

Patient age used in analysis

PATIENT_GENDERstring

Patient gender (Male/Female)

AGE_GROUPstring

Age category (Child/Adolescent/Adult)

PITCH_FLOORnumber

Lower limit for pitch tracking in Hz

PITCH_CEILINGnumber

Upper limit for pitch tracking in Hz

ANALYSIS_METHODstring

Analysis technique used (vocal range, F0 only)

Changes

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