---
title: "Calculate GNE using the validated Michaelis algorithm implemented in Praat"
method: GET
path: "/api/calculate-gne"
tags: ["Advanced Voice Analysis"]
---

# Calculate GNE using the validated Michaelis algorithm implemented in Praat

`GET /api/calculate-gne`

## Request

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

## Query parameters

- `svFileId` string, required

## Response `200`

Successful response

- object
  - `GNE_VALUE` number: Glottal-to-Noise Excitation Ratio on 0-1 scale. Example: 0.425
  - `GNE_DB` number: 10*log10(GNE/(1-GNE)), a Vocametrix convenience transform, not a standard GNE measure (Michaelis 1997 reports GNE on its 0-1 scale). Example: -1.3
  - `MEAN_F0` number: Average fundamental frequency in Hz. Example: 205.3
  - `F0_STD` number: F0 standard deviation indicating pitch stability in Hz. Example: 8.3
  - `HNR` number: Harmonics-to-noise ratio in dB (for comparison with GNE). Example: 12.8
  - `GENDER` string: Sex inferred from F0 against reference ranges (men about 88-172 Hz, women about 194-314 Hz, Banh 2009), otherwise "Undetermined (...)". Example: "Female"
  - `VOICE_QUALITY` string: No verdict: to our knowledge, no validated cutoff exists for Praat GNE. Example: "Not classified (no validated cutoff to our knowledge)"
  - `CLINICAL_RECOMMENDATION` string: Fixed guidance text. Example: "To our knowledge, no validated diagnostic cutoff for GNE in Praat. Interpret with other measures and perceptual evaluation"
  - `METHOD` string: Calculation method identifier. Example: "Native_Praat_GNE"
  - `ANALYSIS_TYPE` string: Analysis type descriptor. Example: "Native_Praat_GNE"
  - `FREQUENCY_RANGE` string: Frequency range analyzed. Example: "500-4500 Hz"
  - `BANDWIDTH` string: Bandwidth used in analysis. Example: "1000 Hz"
  - `STEP_SIZE` string: Step size for frequency analysis. Example: "80 Hz"
  - `ALGORITHM` string: Algorithm reference. Example: "Michaelis_et_al_1997"

## Other responses

- `400`: Bad request — missing or invalid parameter
- `401`: Unauthorized — missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Server error

---

[API](https://skmtc.dev/vocametrix/apis/vocametrix-api.md) · [All operations](https://skmtc.dev/vocametrix/apis/vocametrix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vocametrix/apis/vocametrix-api/revisions/8a54d01bcc81?raw)