Skip to main content
A voice configuration takes one of two shapes. Never both.

​
Composed

Three named provider/model pairs, wired together for you:
All three stages are required. Defaulting a missing one would silently bill you for a model you never chose. Which models you can name, why they must come from one family, and what each costs is on Compose a voice engine.

​
Realtime

One model that does the whole conversation — audio in, audio out, with the reasoning inside the provider:
These two shapes are mutually exclusive. A realtime model has no separate speech-to-text step to name, so asking you to supply one would mean inventing model ids that do not exist.

​
What a call costs

Prices are per connected minute at typical speech rates, including the flat $0.012 orchestration fee. Telephony is not included and not marked up — calls run over your own SIP trunk. The table is generated from the same price book the meter bills against, so it cannot drift from what you are actually charged.

​
Discovering what is available

Call GET /v1/engines rather than hardcoding model ids. An engine whose provider is degraded disappears from that list before your calls start failing, which turns a runtime outage into a visible capability change.

​
Turn taking

interrupt_sensitivity governs how readily the agent stops talking when your caller speaks. high makes it deferential and easy to talk over; low makes it finish its sentence. Short acknowledgements like “yes” or “mm-hm” never interrupt at any setting — they are queued and answered when the agent finishes.