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

per_1000_characters · dialogue_text=14 · ⌈total⌉

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,
  "settlement_status": "RESERVED",
  "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