Use ElevenLabs Turbo 2.5 through Rivya Public API v1 with model id elevenlabs-turbo-2-5, supported inputs, parameters, Files API rules, credits, and response examples.

Available via APIText input readyAudio

API model id

elevenlabs-turbo-2-5

Inputs

text

Files API

Not required for the minimal request

Base credits

Capability

Audio

Billing

METERED

Prompt limit

5000 characters

Request contract

Send the model id at the top level. Model-specific controls belong in params.

Key	Type	Required	Default	Description
model	string	Yes	elevenlabs-turbo-2-5	Use the elevenlabs-turbo-2-5 API model id.
prompt	string	Yes	-	Maximum 5000 characters for this model.
params	object	Yes	-	Model-specific parameter object. Use the rows below for allowed keys.
client_request_id	string	No	-	Optional client-side id for tracing requests in your system.

Model parameters

Key	Type	Required	Default	Range	Options	Description
voice	select	Yes	TX3LPaxmHKxFdv7VOQHJ	-	TX3LPaxmHKxFdv7VOQHJ, cgSgspJ2msm6clMCkdW9, pNInz6obpgDQGcFmaJgB, BIvP0GN1cAtSRTxNHnWS, aMSt68OGf4xUZAnLpTU8	Voice
stability	number	No	0.5	min 0 / max 1 / step 0.05	-	Stability
similarity_boost	number	No	0.75	min 0 / max 1 / step 0.05	-	Similarity boost
style	number	No	0	min 0 / max 1 / step 0.05	-	Style
speed	number	No	1	min 0.7 / max 1.2 / step 0.05	-	Speed
timestamps	select	No	false	-	false, true	Timestamps
previous_text	text	No	-	-	-	Previous text
next_text	text	No	-	-	-	Next text
language_code	text	No	-	-	-	Language code

Minimal request

{
  "model": "elevenlabs-turbo-2-5",
  "prompt": "A polished audio concept for a short product story",
  "params": {
    "voice": "TX3LPaxmHKxFdv7VOQHJ",
    "stability": 0.5,
    "similarity_boost": 0.75,
    "style": 0,
    "speed": 1,
    "timestamps": "false",
    "previous_text": "Optional context before this line",
    "next_text": "Optional context after this line",
    "language_code": "Optional locale code like en or zh"
  }
}

Create response

The create endpoint returns a public task id. Poll the status endpoint until the task succeeds or fails.

{
  "id": "task_elevenlabs_turbo_2_5_example",
  "status": "queued",
  "model": "elevenlabs-turbo-2-5",
  "reserved_credits": 6,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Common errors

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found