Modèles Realtime
Utilisez les modèles ElevenLabs conçus pour des agents vocaux à faible latence.
Vue d’ensemble
Un modèle Realtime est un modèle ElevenLabs conçu pour les conversations vocales à faible latence et disponible pour les agents vocaux.
Chaque agent vocal dispose d’un Mode vocal : Personnalisé ou Realtime. En mode Personnalisé, vous choisissez vous-même le LLM, le modèle TTS et les paramètres ASR, comme décrit dans Modèles. En mode Realtime, vous choisissez un modèle Realtime et ElevenLabs gère ces paramètres pour vous.
Deux modèles Realtime sont disponibles :
Le prompt système, la voix, les outils, la base de connaissances et les paramètres de tour de l’agent fonctionnent de la même manière dans les deux modes.
Vous utilisez une autre API temps réel, comme SpaceXAI ou OpenAI ? L’API Realtime API permet d’essayer plus rapidement les modèles Realtime : pointez votre client existant vers ElevenLabs et conservez les événements que vous utilisez déjà.
Le déploiement des modèles Realtime est progressif. Si le paramètre Mode vocal n’apparaît pas dans l’onglet
Agent de votre agent, les modèles Realtime ne sont pas encore disponibles pour votre Workspace et l’API
rejette realtime_model avec l’erreur Realtime models are not available for this workspace.
Choisir un mode vocal
Conservez l’agent en mode Personnalisé dans l’un des cas suivants :
- L’agent utilise un LLM personnalisé, Amazon Bedrock ou Speech Engine.
- L’agent nécessite un LLM ou un modèle TTS spécifique.
- Des nœuds de workflow remplacent le LLM, le modèle TTS ou un autre paramètre géré.
- L’agent effectue des transferts vers ou depuis des agents en mode Personnalisé.
- L’agent est uniquement textuel. Les modèles Realtime sont conçus pour les conversations vocales.
Sinon, commencez avec Eleven Realtime v1 Mini. Préférez plutôt Eleven Realtime v1 Max lorsque :
- L’agent suit des instructions longues ou complexes, ou s’appuie sur des appels d’outils en plusieurs étapes, et que les réponses de Mini ne suffisent pas.
- L’agent doit respecter le Mode zéro rétention ou la norme HIPAA aux États-Unis ou dans l’UE. Mini n’est disponible dans aucun de ces deux cas.
Max n’est pas disponible dans les environnements de résidence des données en Inde et à Singapour. Il nécessite une limite de jetons d’au moins 1 024, ou aucune limite. Consultez les Limites et la section Conformité et résidence des données.
Configuration
Mettre à jour depuis le Dashboard
Mettre à jour via la CLI
Mettre à jour via l’API
Définir le mode vocal
Définissez le Mode vocal sur Realtime. L’agent bascule vers Eleven Realtime v1 Mini.
Choisir un modèle
Pour utiliser Eleven Realtime v1 Max à la place, sélectionnez-le dans la liste Modèle.
Publier
Publiez vos modifications. La publication échoue si l’agent ne respecte pas l’une des règles indiquées dans Limites.
Pour désactiver Realtime, définissez le Mode vocal sur Personnalisé et publiez. L’agent revient aux paramètres de LLM, de modèle TTS et d’ASR enregistrés pour lui.
Paramètres gérés
Lorsqu’un modèle Realtime est défini, ElevenLabs gère les paramètres suivants et l’agent ignore les valeurs qui y sont enregistrées. Les valeurs enregistrées sont de nouveau utilisées lorsque vous basculez vers Personnalisé.
La limite de jetons (agent.prompt.max_tokens) conserve sa valeur enregistrée, mais les nœuds de workflow ne peuvent pas la remplacer et Eleven Realtime v1 Max requiert une valeur minimale. Consultez Limites.
Pour modifier l’un de ces paramètres, basculez l’agent vers Personnalisé.
Paramètres qui restent applicables
Tous les autres paramètres de l’agent fonctionnent comme en mode Personnalisé, notamment :
- le prompt système et le premier message
- la voix, y compris la prise en charge de plusieurs voix
- les langues
- la température
- les outils et la base de connaissances
- les paramètres de flux de conversation, tels que l’empressement de tour, les délais d’expiration et les interruptions
Le Dashboard masque les paramètres du LLM, y compris la température, lorsque l’agent est en mode Realtime. Utilisez la CLI ou l’API pour modifier la température d’un agent Realtime.
Si le modèle Realtime ne répond pas à temps ou renvoie une erreur, l’agent se rabat sur des LLM de secours comme décrit dans Cascades de LLM. Le modèle Realtime définit combien de temps l’agent attend avant de se rabattre sur un autre modèle.
Limites
ElevenLabs vérifie ces règles lorsque vous publiez l’agent. Un brouillon qui ne respecte pas l’une d’elles est tout de même enregistré, mais la publication échoue avec une erreur indiquant le paramètre à modifier.
- Agents ElevenAgents uniquement : Les agents créés via d’autres produits ElevenLabs, comme Speech Engine, ne peuvent pas utiliser de modèle Realtime.
- Aucun LLM personnalisé : Le mode Realtime n’est pas disponible lorsque le LLM de l’agent est un LLM personnalisé ou Amazon Bedrock. Sélectionnez un LLM intégré en mode Personnalisé avant de basculer.
- Aucun remplacement des paramètres gérés par les workflows : Un nœud de workflow ne peut remplacer aucun paramètre géré ni la limite de jetons. Supprimez le remplacement ou conservez l’agent en mode Personnalisé.
- Limite de jetons pour Max : Eleven Realtime v1 Max nécessite une limite de jetons de 1 024 ou plus, ou aucune limite.
- Transferts entre les modes : Un agent en mode Realtime peut uniquement effectuer des transferts vers et depuis d’autres agents en mode Realtime. Les transferts entre les agents Mini et Max sont pris en charge.
La publication vérifie uniquement les transferts effectués par l’agent publié. Un transfert vers un agent Realtime depuis un agent en mode Personnalisé n’est détecté qu’à la prochaine publication de l’agent en mode Personnalisé. D’ici là, le transfert est rejeté pendant la conversation et l’agent actuel reste en ligne.
Les erreurs de transfert affichent Transfers between default and Realtime model modes are not supported., où « default » signifie le mode Personnalisé.
Conformité et résidence des données
Les modèles Realtime respectent les mêmes règles de Mode zéro rétention, HIPAA et de résidence des données que les autres modèles. La disponibilité diffère entre Mini et Max :
Le Mode zéro rétention s’applique, qu’il soit imposé au niveau du Workspace ou activé sur l’agent.
Si un modèle Realtime n’est pas disponible avec les paramètres de conformité ou de résidence des données de l’agent, ElevenLabs le rejette avec une erreur qui indique le modèle. Choisissez l’autre modèle Realtime ou basculez vers Personnalisé.
Tarification
Un agent Realtime est facturé au tarif standard d’ElevenAgents à la minute, auquel s’ajoutent les jetons d’entrée, d’entrée mis en cache et de sortie aux tarifs du modèle Realtime. Eleven Realtime v1 Max coûte plus cher par jeton qu’Eleven Realtime v1 Mini. Consultez les tarifs d’ElevenLabs pour connaître les tarifs actuels.