Azure Speech TTS

Use Azure Speech to turn text or SSML into a local audio file under download/.

What this skill does

• - Synthesize plain text into speech
• Synthesize full SSML payloads directly
• Choose voice, output format, rate, pitch, style, and role
• Save the result as a local audio file and print a JSON summary

Configuration

This skill uses a small default config file plus environment variables.

Default config file

File:

• - INLINECODE1

Default values:

• - default_voice: INLINECODE3
• INLINECODE4: INLINECODE5
• INLINECODE6: INLINECODE7
• INLINECODE8: INLINECODE9

Secret values

Set these in the local shell environment:

• - INLINECODE10
• INLINECODE11

Optional environment overrides

• - INLINECODE12
• INLINECODE13

Precedence

Use this order:

1. 1. CLI flag
2. Environment variable
3. INLINECODE14
4. Built-in fallback

Quick start

CODEBLOCK0

For SSML:

CODEBLOCK1

Workflow

1. 1. Decide whether the input is plain text or full SSML.
2. Use --text / --text-file for normal narration.
3. Use --ssml / --ssml-file only when the payload already contains a complete <speak> document.
4. Pick the voice and output format, or let config.json supply the defaults.
5. Run scripts/azure_tts.py.
6. Return the generated audio path to the user.

Rules

• - Prefer plain text unless the user needs pauses, emphasis, multi-voice content, or expressive styling.
• INLINECODE22 input must include a full <speak> root element.
• Default voice is zh-CN-Yunqi:DragonHDOmniLatestNeural if nothing else is set.
• Default output folder is download/.
• If the user does not specify format, use the default MP3 output.
• Do not put secrets in config.json.

Common formats

See references/azure-speech-cheatsheet.md for the format map and examples.

Short aliases supported by the script:

• - INLINECODE28
• INLINECODE29
• INLINECODE30
• INLINECODE31

Useful options

• - --voice: Azure voice name, for example INLINECODE33
• INLINECODE34: SSML xml:lang for plain-text mode
• INLINECODE36: speaking rate, for example INLINECODE37
• INLINECODE38: pitch adjustment, for example INLINECODE39
• INLINECODE40: expressive style such as cheerful, sad, INLINECODE43
• INLINECODE44: strength of the expressive style
• INLINECODE45: voice role when supported
• INLINECODE46: write the generated SSML to a file for inspection
• INLINECODE47: print the generated SSML without calling Azure

Output

The helper script writes the audio file and prints JSON like:

CODEBLOCK2

Use the printed output_path as the deliverable path.