Skip to content

World's first open-source, agentic video production system. 12 production pipelines, 100+ tools, 700+ agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.

Merge remote-tracking branch 'origin/main' into codex/repair-pr-371

calesthio329628a22b51
diff --cc docs/PROVIDERS.md
index 35e94a6d,65c34f51..2b680e06
--- a/docs/PROVIDERS.md
+++ b/docs/PROVIDERS.md
@@@ -428,67 -450,9 +450,67 @@@ allowance). OpenMontage estimates cost
---
+### Azure AI Speech — Text-to-Speech
+
+> **Cloud neural narration.** Azure neural TTS delivers high-quality multilingual voices with SSML prosody control and express-as styles — same Speech resource as `azure_stt`, so one key/region unlocks both directions. Optional: the local `piper_tts` remains the default offline TTS path. When `AZURE_SPEECH_KEY` is set, the agent may prefer `azure_tts` for cloud narration.
+
+**Tools unlocked:** `azure_tts`
+**Env vars:** `AZURE_SPEECH_KEY`, `AZURE_SPEECH_REGION` (or `AZURE_TTS_ENDPOINT`)
+
+#### Setup
+
+Identical to the STT setup above — the same Speech resource key and region work
+for both. If you already configured `azure_stt`, `azure_tts` is available now.
+
+```bash
+AZURE_SPEECH_KEY=your-speech-resource-key
+AZURE_SPEECH_REGION=eastus
+# AZURE_TTS_ENDPOINT=https://<region>.tts.speech.microsoft.com # optional, overrides region
+```
+
+Note: the TTS host (`<region>.tts.speech.microsoft.com`) differs from the STT
+endpoint, so the optional override var is `AZURE_TTS_ENDPOINT`, not
+`AZURE_SPEECH_ENDPOINT`.
+
+#### API Notes
+
+OpenMontage uses the synchronous REST v1 endpoint with an SSML body — no token
+exchange, Blob storage, or job polling:
+
+```text
+POST https://{region}.tts.speech.microsoft.com/cognitiveservices/v1
+Ocp-Apim-Subscription-Key: ${AZURE_SPEECH_KEY}
+Content-Type: application/ssml+xml
+X-Microsoft-OutputFormat: audio-48khz-192kbitrate-mono-mp3
+```
+
+Voice shortlist aliases: `andrew` (default — warm, confident), `brandon`
+(deeper), `ava` (bright female), `guy` (authoritative), `jenny` (friendly). Any
+Azure voice short name is accepted verbatim. See the `azure-text-to-speech`
+skill for SSML `rate`/`pitch`/`style` guidance.
+
+#### What It Is Best For
+
+- High-quality neural narration on existing Azure credentials
+- Calm, confident explainer / founder-register delivery
+- Multilingual narration via the *Multilingual* voice family
+- Deterministic re-renders (fixed voice + SSML → identical audio)
+
+Not for: fully offline production (use `piper_tts`) or voice cloning (use
+`elevenlabs_tts`).
+
+#### Pricing
+
+Azure neural TTS Standard (S0) bills roughly **$16 per 1M characters** (a free
+F0 tier includes a limited monthly allowance). A 150-word narration segment
+costs about $0.015. OpenMontage estimates cost from character count. See
+[Azure AI Speech pricing](https://azure.microsoft.com/pricing/details/cognitive-services/speech-services/) for current rates.
+
+---
+
### Google — TTS + Imagen + Music + Video (Shared Key)
- > **One key, five tools.** Google Cloud TTS has 700+ voices in 50+ languages — the strongest localization option. Imagen 4 generates high-quality images. Google Lyria generates high-quality background music. Gemini Omni Flash supports conversational video editing, and direct Veo generation covers premium short video clips.
+ > **One key, five tools.** Google Cloud TTS has 700+ voices in 50+ languages — the strongest localization option. `google_imagen` supports both Imagen 4 and Gemini 2.5 Flash Image, including projects without Imagen catalog access. Google Lyria generates high-quality background music. Gemini Omni Flash supports conversational video editing, and direct Veo generation covers premium short video clips.
**Tools unlocked:** `google_tts`, `google_imagen`, `google_music`, `gemini_omni_video`, `veo_video`
**Env var:** `GOOGLE_API_KEY` (or `GEMINI_API_KEY` — either works; `GEMINI_API_KEY` takes precedence)