Speech

Submit text, voice, and output-format parameters. The response body contains binary audio that the client should save or process using the requested format.

POST/v1/audio/speech

Converts input text to speech and returns the result as binary audio content.

Authorization

bearerAuth

AuthorizationBearer <token>

Use Bearer your-api-key in the Authorization Header.

In: header

Request Body

application/json

Text-to-speech request parameters.

TypeScript Definitions

Use the request body type in TypeScript.

model*string

The text-to-speech model ID to be used, such as tts-1 and tts-1-hd. The actual available models are based on the model list returned by the current API Key.

Length1 <= length

input*string

The text to be converted into speech has a maximum length of 4096 characters.

Length1 <= length <= 4096

voice*string

The voice used when generating speech.

Value in

"alloy"
"ash"
"ballad"
"coral"
"echo"
"fable"
"nova"
"onyx"
"sage"
"shimmer"
"verse"
"marin"
"cedar"

instructions?string

Control the tone, expression style, or other speaking requirements for generated speech.

Lengthlength <= 4096

response_format?string

Audio output format.

Default"mp3"

Value in

"mp3"
"opus"
"aac"
"flac"
"wav"
"pcm"

speed?number

Speech generation speed, ranging from 0.25 to 4.0.

Range0.25 <= value <= 4

Default1

stream_format?string

Streaming response format. audio Returns a binary audio stream, sse Returns semantic audio events.

Default"audio"

Value in

"audio"
"sse"

Response Body

`application/json`

curl -X POST "https://example.com/v1/audio/speech" \  -H "Authorization: Bearer your-api-key" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "input": "Hello, World!",    "voice": "alloy"  }' \  --output speech.mp3

The response body is not JSON. Please save the binary content as an audio file according to the requested output format.

<binary audio data>

Authorization

Request Body

Response Body

200application/octet-stream

400application/json

401application/json

403application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`