Transcribe
Routes the request to the best STT provider for your `(language, region, optimizeFor)` intent, with automatic failover to runner-up providers. Body is binary audio. Routing intent goes in the `x-speko-intent` header (JSON).
Authorization
bearerAuth In: header
Header Parameters
JSON-encoded RoutingIntent. Example: {"language":"en-US","region":"global"}.
Optional JSON-encoded PipelineConstraints. Each allowedProviders entry is either "<vendor>" (any model from that vendor) or "<vendor>:<model>" (a specific model). Example: {"allowedProviders":{"stt":["deepgram:nova-3"]}}.
Optional JSON-encoded STT options, max 4 KB. Fields: keywords (string[], <=200, vocabulary bias), language (BCP-47 or auto, provider-level override that does not change routing), workload (conversation | transcription | narration, applies registry defaults per provider), diarization (batch-only boolean, demote-class: incapable providers are excluded from failover; 422 no_capable_provider when none remain), speakersExpected (integer hint), smartFormat (boolean), fillerWords (boolean), profanityFilter (boolean), providerOptions (per-provider params validated against the registry, e.g. {"deepgram":{"dictation":true}}; apply only when that provider serves the request and never cross providers on failover). Example: {"workload":"transcription","diarization":true}.
Audio MIME type, e.g. audio/wav, audio/mpeg, audio/pcm;rate=16000.
Binary audio. WAV, MP3, or raw PCM accepted.
TypeScript Definitions
Use the request body type in TypeScript.
binaryResponse Body
text/event-stream
application/json
application/json
application/json
"string"{
"error": "Audio body is empty.",
"code": "INVALID_AUDIO"
}{
"error": "Unauthorized",
"code": "UNAUTHORIZED"
}{
"error": "All providers failed",
"code": "TRANSCRIBE_FAILED"
}Create phone session
POST /v1/sessions/phone — place an outbound PSTN call backed by a Speko voice session.
Synthesize
Routes the request to the best TTS provider for your intent, with automatic failover. Returns binary audio. The `Content-Type` header (mirrored in `X-Speko-Audio-Format`) tells you the format.