> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Modèles Realtime

## 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](/docs/fr/eleven-agents/customization/llm). En mode Realtime, vous choisissez un modèle Realtime et ElevenLabs gère ces paramètres pour vous.

Deux modèles Realtime sont disponibles :

| Modèle                      | Valeur de `realtime_model` | Description                                                                                                                          |
| --------------------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **Eleven Realtime v1 Mini** | `eleven_realtime_v1_mini`  | Le modèle Realtime par défaut. Latence et coût minimaux.                                                                             |
| **Eleven Realtime v1 Max**  | `eleven_realtime_v1_max`   | Raisonne avant de répondre, pour les instructions complexes et l’utilisation d’outils en plusieurs étapes. Coûte plus cher que Mini. |

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.

> **Tip**
>
> Vous utilisez une autre API temps réel, comme SpaceXAI ou OpenAI ? L’[API Realtime API](/docs/fr/eleven-agents/guides/openai-realtime-compatibility) 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à.

> **Note**
>
> 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é](/docs/fr/eleven-agents/customization/llm/custom-llm), Amazon Bedrock ou [Speech Engine](/docs/fr/eleven-api/guides/cookbooks/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é](#managed-settings).
* 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](/docs/fr/eleven-agents/customization/privacy/zrm) ou la norme [HIPAA](/docs/fr/eleven-agents/legal/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](#limitations) et la section [Conformité et résidence des données](#compliance-and-data-residency).

## Configuration

#### Mettre à jour depuis le Dashboard

#### Ouvrir l’onglet Agent

Ouvrez votre agent dans le Dashboard et accédez à l’onglet **Agent**.

#### 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](#limitations).

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.

#### Mettre à jour via la CLI

#### Récupérer la configuration de l’agent

```bash
elevenlabs agents pull --agent "<agent-name>"
```

#### Modifier \`agent_configs/\<agent-name>.json\`

Définissez `conversation_config.realtime_model` :

```json
{
  "conversation_config": {
    "realtime_model": "eleven_realtime_v1_mini"
  }
}
```

Pour désactiver Realtime, définissez `realtime_model` sur `null`.

#### Envoyer vos modifications

```bash
elevenlabs agents push --agent "<agent-name>"
```

#### Mettre à jour via l’API

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.agents.update(
    agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6",
    conversation_config={
        "realtime_model": "eleven_realtime_v1_mini",
    },
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", {
  conversationConfig: {
    realtimeModel: "eleven_realtime_v1_mini",
  },
});
```

Pour désactiver Realtime, définissez `realtime_model` sur `None` en Python ou `realtimeModel` sur `null` en TypeScript.

## 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é.

| Paramètre                        | Champ dans `conversation_config`          |
| -------------------------------- | ----------------------------------------- |
| LLM                              | `agent.prompt.llm`                        |
| Niveau de raisonnement           | `agent.prompt.reasoning_effort`           |
| Budget de réflexion              | `agent.prompt.thinking_budget`            |
| Appels d’outils parallèles       | `agent.prompt.enable_parallel_tool_calls` |
| Délai d’expiration de la cascade | `agent.prompt.cascade_timeout_seconds`    |
| Modèle TTS                       | `tts.model_id`                            |
| Mode expressif                   | `tts.expressive_mode`                     |
| Fournisseur ASR                  | `asr.provider`                            |

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](#limitations).

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](/docs/fr/eleven-agents/customization/voice/multi-voice-support)
* les [langues](/docs/fr/eleven-agents/customization/voice/customization/language)
* la température
* les [outils](/docs/fr/eleven-agents/customization/tools) et la [base de connaissances](/docs/fr/eleven-agents/customization/knowledge-base)
* les paramètres de [flux de conversation](/docs/fr/eleven-agents/customization/conversation-flow), 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](/docs/fr/eleven-agents/customization/llm/llm-cascading). 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](/docs/fr/eleven-api/guides/cookbooks/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é](#managed-settings) 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](/docs/fr/eleven-agents/customization/tools/system-tools/agent-transfer) vers et depuis d’autres agents en mode Realtime. Les transferts entre les agents Mini et Max sont pris en charge.

> **Warning**
>
> 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](/docs/fr/eleven-agents/customization/privacy/zrm), [HIPAA](/docs/fr/eleven-agents/legal/hipaa) et de [résidence des données](/docs/fr/overview/administration/data-residency) que les autres modèles. La disponibilité diffère entre Mini et Max :

| Environnement                     | Eleven Realtime v1 Mini | Eleven Realtime v1 Max                 |
| --------------------------------- | ----------------------- | -------------------------------------- |
| États-Unis                        | Disponible              | Disponible                             |
| Résidence des données européenne  | Disponible              | Disponible                             |
| Résidence des données en Inde     | Disponible              | Non disponible                         |
| Résidence des données à Singapour | Disponible              | Non disponible                         |
| Mode zéro rétention et HIPAA      | Non disponible          | Disponible aux États-Unis et dans l’UE |

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](https://elevenlabs.io/pricing) pour connaître les tarifs actuels.

## Ressources associées

* [Modèles](/docs/fr/eleven-agents/customization/llm)
* [Cascades de LLM](/docs/fr/eleven-agents/customization/llm/llm-cascading)
* [Transfert d’agent](/docs/fr/eleven-agents/customization/tools/system-tools/agent-transfer)
* [Mode zéro rétention](/docs/fr/eleven-agents/customization/privacy/zrm)
* [Conformité HIPAA](/docs/fr/eleven-agents/legal/hipaa)