Skip to main content
POST
Generate speech audio
See the Audio API guide for request examples, limits, billing and delivery behavior.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string

Reuse the same key and body after a timeout to recover accepted work without generating or charging twice.

Required string length: 1 - 128

Body

application/json
model
enum<string>
required
Available options:
eleven_v3,
eleven_v4,
eleven_v4_turbo
mode
enum<string>
default:text_to_speech
Available options:
text_to_speech,
text_to_dialogue
prompt
string

Speech text. Maximum 2,000 Unicode code points including whitespace and tags across the request.

dialogue
object[]

v3/v4 only; at most ten distinct voices. Omit prompt and controls.voiceId.

Maximum array length: 100
controls
object
providerOptions
object
webhookEndpointId
string
stream
boolean
default:false

Response

Success

The response is of type file.