---
title: "Audio Reports"
description: "Enable narration, play a report, and resolve missing audio."
canonical: https://y2.dev/docs/audio/
---

Audio Reports

# Audio Reports

Enable narration, play a report, and resolve missing audio.

Audio Reports turn a report into MP3 narration. The feature requires a Pro or Elite workspace. The profile editor labels it **Alpha**.

Enable narration before a report runs. This setting does not add audio to existing reports. Audio generation can also be disabled by the service operator.

## Enable narration for a profile

1. Open **InfoOps → My Profiles**.
2. Create or edit a profile.
3. Open **Advanced Configuration**.
4. Enable **Audio Narration**.
5. Preview and select a voice.
6. Choose a generation speed.
7. Select a synced pronunciation dictionary if needed.
8. Save the profile.

Y2 attempts narration when the profile next produces a complete report. Open that report and check for **Listen**.

Match the dictionary language

The dictionary selector does not filter by voice language. Check the language badge before assigning a dictionary.

## Play and deliver audio

Select **Listen** on a report with audio. The player supports pause, seeking, download, and playback speed. Email delivery links to the report page when narration exists. It does not attach the MP3.

See [Audio reference](https://y2.dev/docs/audio/reference) for voice settings, output limits, and delivery behavior.

## Create a pronunciation dictionary

Use the [dictionary setup guide](https://y2.dev/docs/audio/dictionaries) to define replacements and verify provider sync.

## Customize spoken branding

Open **InfoOps → Audio** to edit a branding template's intro and outro. Use the [Branding Templates editor](https://y2.dev/docs/profiles/branding) for before-report and after-report audio. Assign the template to the profile to apply it.

## Retrieve audio through the API

Use the [Reports API guide](https://y2.dev/docs/api/reports) and [audio endpoint reference](https://y2.dev/docs/api/reference/reports/getReportAudio). The endpoint requires `reports:audio` or its supported x402 payment flow.

## Troubleshoot audio

**Audio Narration is disabled**

Confirm that the active workspace is Pro or Elite. Service configuration can also disable new audio generation.

**The report has no Listen button**

Confirm that narration was enabled before the run. Incomplete reports, provider failures, output limits, or budget limits can prevent audio. Report delivery can continue without narration.

**A dictionary has no effect**

Confirm that the profile uses the intended dictionary and its status is **Synced**. Check that the dictionary and voice languages match.

**The duration changes after playback starts**

Y2 first shows a text-based estimate. The player replaces it with the file's duration after loading.

**The API returns 404**

Check the public report ID, your access, and whether the report has audio. Missing audio uses the same not-found response.
