> ## Documentation Index
> Fetch the complete documentation index at: https://docs.corti.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Audio Events

> Learn about feedback sent to client about audio health

**Audio events** enable real-time events in audio stream about quality and speech activity. Such alerts are intended to notify integrator of audio quality degradation, periods of silence, or other events that could support application behavior or user warnings.

<Card title="Feature availability:">
  <Columns cols={3}>
    <Card icon="circle-check" horizontal href="/stt/transcribe">
      /transcribe
    </Card>

    <Card icon="circle-check" horizontal href="/stt/streams">
      /streams
    </Card>

    <Card icon="circle-x" horizontal href="/stt/transcripts">
      /transcripts
    </Card>
  </Columns>

  <br />

  <Tip>
    Use of this feature is recommended to support users with feedback about noise or audio issues that can impact quality of transcripts.
  </Tip>
</Card>

***

## API Definitions

| Parameter   | Type    | Definition                         |
| :---------- | :------ | :--------------------------------- |
| audioEvents | object  | Container for audio event settings |
| enabled     | boolean | Set to true to enable the feature  |

See API details for `transcribe` [here](/api-reference/transcribe#param-audio-events) and `streams` [here](/api-reference/streams#param-audio-events).

See Audio Events server message details for `transcribe` [here](/api-reference/transcribe#audio-events) and `streams` [here](/api-reference/streams#audio-events).

***

## Supported Audio Events

### Speech Quality Issue

The `speechQualityIssueDetected` event is detected when excessive background sound, white noise, or other disruption in speech quality is detected by the speech to text system. After a `speechQualityIssueDetected` message is sent to the client, a `speechQualityIssueRecovered` message will be sent when audio health returns within normal limits.

### Long Silence

The `longSilence` event is detected when 10 seconds of continuous silence (no speech) is detected by the speech to text system. After a `longSilenceDetected` message is sent to the client, a `longSilenceRecovered` message will be sent upon detection of speech.

<br />

<Note>
  Audio events alert thresholds are currently defined on the Corti speech to text services, and cannot be controlled by client configuration. The only client configuration supported is to enabling the Audio Event messages.

  Please [contact us](https://help.corti.app) for further information.
</Note>