Skip to main content
POST
curl

Authorizations

Authorization
string
header
required

An account API key. Send it as Authorization: Bearer <key>.

Body

application/json

The request body of POST /v1/audio/speech, answered with audio.

model
string
required

The speech model to synthesise with, named by its id or alias.

input
string
required

The text to read aloud, at most 32768 Unicode characters.

voice
string
required

The voice to read in, by the name the model knows it under.

speed
number<double> | null

How fast to read, as a multiplier of the model's normal pace. Zero or less draws a 400.

instructions
string | null

Free-form direction for how the text should be delivered.

response_format
null | enum<string>

The audio container to synthesise into, which also sets the answer's Content-Type.

Available options:
mp3,
opus,
aac,
flac,
wav,
pcm

Response

The synthesised audio itself, streamed as it is produced. Content-Type names the container response_format asked for, or audio/mpeg when the key was left out and the provider named none of its own.