Azure AI Speech Voices and Locales Documentation Generator

This simple console app generates markdown tables for Azure AI Speech supported languages, text-to-speech voices, and their features. It uses some of the Azure AI Speech REST APIs to fetch the data and formats it into markdown files.

The generated markdown tables can be used to replace the existing tables in the Azure AI documentation repository.

An example of rendered language and locales tables at learn.microsoft.com can be found here.

Setup

1. Prerequisites:

   • .NET 8.0 or later
   • C# 12 or later (required for collection expression syntax)

2. Install dependencies:

   dotnet add package Newtonsoft.Json
   dotnet add package DotNetEnv

3. Create a .env file in the project root with your Azure Speech credentials:

   SPEECH_KEY=your-key-here
   SPEECH_REGION=your-region-here

4. Run the application:

   dotnet run

What it does

Generates markdown tables for Azure AI Speech voices, locales, and features. Output files are saved in the output/ directory:

• language-identification.md: Language identification support
• stt.md: Speech to text languages and features
• tts.md: Text to speech voices
• voice-styles-and-roles.md: Voice styles and roles