Audio Formats And Encoding

Agent requests output_format=raw PCM but writes the bytes to a '.wav' file and serves it as audio/wav.

Match the container to how the bytes will be consumed: request a wav container (with header) when serving a .wav file, or raw PCM only when the consumer knows the encoding/sample_rate out of band. Do not label raw PCM as wav — players will misread the missing header.

A low-latency streaming agent picks mp3 output for everything, including the real-time leg where decode/framing adds latency.

Choose encoding by use case: prefer raw/PCM (or the documented low-latency encoding) for real-time streaming where decode overhead matters; use mp3/compressed for storage/download where size matters. Do not blanket-apply one container.

Agent requests one sample_rate from /tts but configures the audio player at a different rate, producing pitch-shifted audio.

Use the same sample_rate for synthesis request and playback/decode. For raw PCM, carry the sample_rate alongside the bytes so the consumer decodes correctly. Verify the played rate equals the requested rate in tests.