Utilisez ElevenLabs Dialogue V3 via Rivya Public API v1 avec le model id elevenlabs-dialogue-v3, les entrées prises en charge, les paramètres, les règles Files API, les crédits et des exemples de réponse.

Disponible via APIEntrée texte prêteAudio

ID de modèle API

elevenlabs-dialogue-v3

Entrées

text

Files API

Non requis pour la requête minimale

Crédits de base

per_1000_characters · dialogue_text=14 · ⌈total⌉

Capacité

Audio

Facturation

METERED

Limite de prompt

5000 caractères

Contrat de requête

Envoyez l'ID du modèle au niveau supérieur. Les contrôles propres au modèle vont dans params.

Clé	Type	Obligatoire	Par défaut	Description
model	string	Oui	elevenlabs-dialogue-v3	Utilisez elevenlabs-dialogue-v3 comme ID de modèle API.
prompt	string	Non	-	Maximum 5000 caractères pour ce modèle.
params	object	Non	-	Objet de paramètres propre au modèle. Consultez les lignes ci-dessous pour les clés autorisées.
client_request_id	string	Non	-	ID côté client facultatif pour tracer les requêtes dans votre système.
params.dialogue	array	Oui	-	Lignes de dialogue sous forme d'objets avec voice et text. Le serveur construit le prompt de tâche à partir de ce tableau.

Paramètres du modèle

Clé	Type	Obligatoire	Par défaut	Plage	Options	Description
default_voice	select	Non	Adam	-	Adam, Alice, Bill, Brian, Callum, Charlie, Chris, Daniel, Eric, George, Harry, Jessica, Laura, Liam, Lily, Matilda, River, Roger, Sarah, Will	Voix par défaut
stability	select	Non	0.5	-	0, 0.5, 1	Stabilité
language_code	text	Non	-	-	-	Code de langue

Requête minimale

{
  "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."
      }
    ]
  }
}

Réponse de création

L'endpoint de création renvoie un ID de tâche public. Interrogez l'endpoint de statut jusqu'à ce que la tâche réussisse ou échoue.

{
  "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
}

Erreurs courantes

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found