Sign in

v2

latestOpenAPI 3.1.02026-08-0514431.6 KB

Synthesize PCM, chunked as it decodes

The same body as POST /v1/synthesize, except the response body starts as soon as the first vendor chunk decodes instead of after the whole synthesis. Selection, failover and the routing headers all complete before the first byte; a vendor failure after that ends the body rather than switching voices mid-utterance.

post/v1/synthesize/stream

Headers

X-Speko-Objective'latency' | 'quality' | 'cost' | 'balanced'

Routing objective. Defaults to the route policy.

X-Speko-Languagestring

BCP 47 language tag used for benchmark selection and provider transcription.

X-Speko-Allowstring

Comma-separated providers or provider:model ids to allow.

X-Speko-Denystring

Comma-separated providers or provider:model ids to exclude.

X-Speko-Max-Pricenumber

Maximum published benchmark price for the request stage: STT in USD per minute, LLM in USD per 1M tokens, or TTS in USD per 1M characters. Candidates without a published price are excluded when this constraint is set.

Request body

OR

Response

Signed 16-bit mono 24 kHz PCM, chunked as each vendor chunk decodes. x-speko-first-byte-ms is absent by design: it is not yet known when these headers are written, which is the point of the route.