Advanced Voice Analysis

Calculate S/Z ratio with age-specific interpretation and quality assessment

get/api/calculate-sz-ratio

Request

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

Query parameters

sFileIdstring required

ID of the /s/ sound audio file (previously uploaded) - REQUIRED

zFileIdstring required

ID of the /z/ sound audio file (previously uploaded) - REQUIRED

patientAgenumber required

Patient age in years (for context) - REQUIRED

genderstring required

Patient gender ("male" or "female") - REQUIRED

clinicalContextstring

Clinical context ("screening", "therapy", "neurological", "post-surgical") - default: "screening"

silenceThresholdnumber

Silence detection threshold in dB - default: -30

minVoicedDurationnumber

Minimum voiced segment duration in seconds - default: 0.1

minVoicelessDurationnumber

Minimum voiceless segment duration in seconds - default: 0.1

edgePaddingnumber

Edge padding to avoid artifacts in seconds - default: 0.05

maxRecordingDurationnumber

Maximum recording duration in seconds - default: 30

chunkDurationnumber

Analysis chunk duration in seconds - default: 10

versionstring

S/Z analysis algorithm version - default: "v01"

Response

Successful response

S_PHONATION_TIMEnumber

Total sustained /s/ phonation duration in seconds. Example: 18.7

Z_PHONATION_TIMEnumber

Total sustained /z/ phonation duration in seconds. Example: 19.2

SZ_RATIOnumber

S/Z phonation time ratio (primary clinical measure). Example: 0.97

S_EFFICIENCYnumber

Percentage of /s/ recording with actual phonation. Example: 85.4

Z_EFFICIENCYnumber

Percentage of /z/ recording with actual phonation. Example: 87.2

S_PHONATION_SEGMENTSnumber

Number of continuous /s/ phonation segments. Example: 3

Z_PHONATION_SEGMENTSnumber

Number of continuous /z/ phonation segments. Example: 2

S_LONGEST_SEGMENTnumber

/s/ longest continuous segment duration in seconds. Example: 12.5

Z_LONGEST_SEGMENTnumber

/z/ longest continuous segment duration in seconds. Example: 15.8

MEAN_F0_Znumber

Mean fundamental frequency during /z/ phonation in Hz. Example: 195.8

F0_STD_Znumber

Standard deviation of F0 during /z/ phonation in Hz. Example: 8.3

F0_CV_Znumber

Coefficient of variation of F0 during /z/ in %. Example: 4.2

RELIABILITY_SCOREnumber

Composite reliability score (0-4). Example: 3.8

PRESBYLARYNGIS_RISKinteger

Age flag (0/1), informational only: to our knowledge, no validated age-specific S/Z cut-off exists. Example: 0

SZ_INTERPRETATIONstring

Text label for the ratio; only the 1.4 cut-off has a published source (Eckel & Boone 1981). Example: "Normal S/Z ratio"

CLINICAL_SIGNIFICANCEstring

Pathophysiology interpretation. Example: "No evidence of vocal fold mass lesions"

RISK_LEVELstring

Stratified risk assessment. Example: "Low"

RELIABILITYstring

Test reliability classification. Example: "High reliability"

AGE_ADJUSTMENTstring

Age-specific interpretation note. Example: "No age-related adjustments needed"

GENDERstring

Gender classification. Example: "Female"

PATIENT_AGEinteger

Patient age in years. Example: 35

PATIENT_GENDERstring

Patient gender classification. Example: "Female"

AGE_GROUPstring

Age-based clinical grouping. Example: "Young Adult"

AGE_NOTEstring

Age-related clinical note. Example: "Age within normal vocal range"

GENDER_NOTEstring

Gender-specific clinical note. Example: "Female-typical phonation patterns"

EXPECTED_SZ_RANGEstring

Expected S/Z ratio range for demographics. Example: "0.85-1.15"

PHONATION_QUALITYstring

Overall phonation quality assessment. Example: "Good phonatory control"

Changes

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