Use ElevenLabs Dialogue V3 through Rivya Public API v1 with model id elevenlabs-dialogue-v3, supported inputs, parameters, Files API rules, credits, and response examples.

Available via APIText input readyAudio

API model id

elevenlabs-dialogue-v3

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-dialogue-v3	Use the elevenlabs-dialogue-v3 API model id.
prompt	string	No	-	Maximum 5000 characters for this model.
params	object	No	-	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.
params.dialogue	array	Yes	-	Dialogue lines as objects with voice and text. The server builds the task prompt from this array.

Model parameters

Key	Type	Required	Default	Range	Options	Description
default_voice	select	No	Adam	-	Adam, Alice, Bill, Brian, Callum, Charlie, Chris, Daniel, Eric, George, Harry, Jessica, Laura, Liam, Lily, Matilda, River, Roger, Sarah, Will	Default voice
stability	select	No	0.5	-	0, 0.5, 1	Stability
language_code	text	No	-	-	-	Language code

Minimal request

{
  "model": "elevenlabs-dialogue-v3",
  "prompt": "A polished audio concept for a short product story",
  "params": {
    "default_voice": "Adam",
    "stability": "0.5",
    "dialogue": [
      {
        "voice": "Adam",
        "text": "Welcome to the product walkthrough."
      },
      {
        "voice": "Alice",
        "text": "Here is the short version for developers."
      }
    ]
  }
}

Create response

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

{
  "id": "task_elevenlabs_dialogue_v3_example",
  "status": "queued",
  "model": "elevenlabs-dialogue-v3",
  "reserved_credits": 14,
  "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