v7.12.0

7.12.0 (2026-10-01)

Features

• Flux TTS controls: Add inline pause markers for Flux batch synthesis and IPA pronunciation overrides for Flux batch, Flux WebSocket, and Aura-2. Pronunciation is Early Access; pauses are Flux batch-only. See Speed, Pause, Pronunciation. (#797) (d2b5514)
• TextBuilder migration: Emit the escaped marker syntax Flux accepts: pauses as \{pause:500ms\} and pronunciations as \{"word": "...", "pronounce": "<IPA>"\}. The 7.11.0 forms are rejected or ignored by /v2/speak, so upgrade when using TextBuilder with Flux TTS.
• TextBuilder validation: Match Flux batch limits: pauses must be 500-3000 ms in 100 ms increments, with at most eight per request. pause(), from_ssml(), and build() now raise ValueError for malformed, out-of-range, off-grid, or mixed pause-and-pronunciation controls before sending a request the API would reject.
• Listen v2 (Flux): Add typed Warning responses while retaining dict-style response access during the v7 transition.

Compatibility

• Topics and Intents: Type the direct API segments response shape while retaining deprecated results facades, legacy import paths, and legacy construction throughout v7.