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

### Musique

- **API Music Finetunes** : ajout de la prise en charge par API de la gestion des [Music Finetunes](/docs/fr/eleven-creative/products/music/finetunes). Cinq points de terminaison permettent de créer un Finetune à partir d'audio importé, de lister les Finetunes accessibles, de récupérer le statut d'entraînement, de mettre à jour les métadonnées et la visibilité, ou de supprimer un Finetune. Toutes les méthodes SDK de génération musicale exposent désormais `finetune_id`.

### ElevenAgents

- **Résolution de références de conversations externes** : ajout de `GET /v1/convai/conversations/resolve` pour résoudre l'URL d'un message Slack ou d'un ticket Zendesk en conversation. Les requêtes exigent les paramètres de requête `agent_id` et `reference` (chaînes).
- **Interroger les bases de connaissances des agents** : ajout de `POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query` pour les requêtes RAG en lecture seule sur la base de connaissances d'un agent. La requête exige `query` (chaîne), accepte `branch_id` (chaîne) facultatif et renvoie des segments classés avec des métadonnées sur le document, le segment, le texte et la distance vectorielle. Ce point de terminaison est exclu des SDK générés.
- **Formats de contenu de la base de connaissances** : les réponses des fichiers, textes et URL de la base de connaissances ajoutent `content_format` (`html` | `markdown`, `html` par défaut) facultatif.
- **Configuration vocale de l'agent** : les schémas de remplacement TTS ajoutent `model_id` (`TTSConversationalModel`) facultatif et remplaçable côté client. La valeur par défaut de `enable_phoneme_tags` passe de `false` à `true`.
- **Cascade LLM de secours plus rapide** : la valeur par défaut de `cascade_timeout_seconds` passe de 8 à 4 secondes. La plage autorisée reste de 2 à 15 secondes.
- **Sources de valeurs des paramètres d'outil** : les paramètres d'outil objet peuvent désormais utiliser `dynamic_variable`, `constant_value` ou `is_omitted`, comme les contrôles scalaires et de tableaux existants. Les remplacements de schéma constants acceptent désormais des tableaux et objets arbitraires.
- **Garde-fous sur la réponse complète** : les garde-fous personnalisés ajoutent `evaluate_full_response_only` (booléen, `false` par défaut) facultatif pour évaluer une seule fois la réponse complète non-TTS. Cette option nécessite le mode de blocage.
- **Enregistrement d'appels Twilio** : la configuration des appels de téléphonie ajoute `twilio_call_recording_enabled` (booléen, `false` par défaut) facultatif. Les enregistrements sont stockés dans le compte Twilio connecté et ce paramètre est ignoré par les autres fournisseurs.
- **Texte d'importation de fichiers du widget** : la configuration de texte du widget ajoute des libellés et messages d'erreur facultatifs pour joindre et supprimer des fichiers, les échecs d'importation, les types non pris en charge, les fichiers trop volumineux, les limites de nombre de fichiers et l'indicateur de saisie.
- **Statut de synchronisation de la base de connaissances** : les réponses de fichiers de la base de connaissances ajoutent `auto_sync_info` et `refresh_status` (`FileRefreshStatus`) facultatifs. Les réponses de dossiers ajoutent `document_count` (entier) obligatoire, un décompte récursif des documents hors dossiers plafonné à 1 000.
- **Filtres de recherche textuelle dans les conversations** : [Text search conversation messages](/docs/fr/api-reference/conversations/messages/text-search) ajoute les paramètres de requête de tableau `exclude_statuses` et `termination_reasons` facultatifs.
- **Options LLM** : la configuration LLM de l'agent ajoute `gpt-5.6-sol`, `gpt-5.6-terra` et `gpt-5.6-luna`. `LLMReasoningEffort` ajoute `max`.
- **Indicateurs de saisie WhatsApp** : les schémas de requête et de réponse des comptes WhatsApp ajoutent `enable_typing_indicator` (booléen) facultatif.

### Speech to Text

- **Authentification par lot à usage unique** : [Convert speech to text](/docs/fr/api-reference/speech-to-text/convert) ajoute `token` (chaîne) facultatif comme alternative à l'authentification par clé API ou jeton porteur. Créez le jeton à usage unique avec `POST /v1/single-use-token/batch_scribe` ; il expire après 15 minutes.
- **Fiabilité du client temps réel** : `@elevenlabs/client` signale désormais les erreurs de configuration du microphone et les erreurs de serveur malformées via `RealtimeEvents.ERROR`, libère les ressources du microphone après les échecs de configuration et la fermeture de connexion, et ignore les trames tardives du microphone après l'arrêt du socket.

### Text to Speech

- **Dictionnaires de prononciation archivés** : [List pronunciation dictionaries](/docs/fr/api-reference/pronunciation-dictionaries/list) ajoute `include_archived` (booléen, `true` par défaut) facultatif.

### Workspaces

- **Abonnements aux événements webhook** : les requêtes [Update workspace webhook](/docs/fr/api-reference/webhooks/update) ajoutent `events` (`WorkspaceWebhookEventType[]`) facultatif avec `voice_library_removal_notice`, `speech_to_text` et `agent_qa`. Les réponses webhook peuvent renvoyer la liste des événements abonnés.
- **Dimensions des analyses d'utilisation** : [Get workspace usage](/docs/fr/api-reference/analytics/workspace/usage) ajoute `surface` et `actor` aux valeurs de `group_by`.
- **Suppression des limites des comptes de service** : [Update service account API key](/docs/fr/api-reference/service-accounts/api-keys/update) accepte `character_limit: "clear"` pour supprimer une limite mensuelle de caractères, en plus de `"no_update"` et des valeurs entières.
- **Références webhook pour les alertes** : les schémas de notificateur webhook d'alerte identifient désormais un webhook de Workspace à l'aide de `webhook_id` (chaîne) obligatoire au lieu d'intégrer `url`, `method` et `headers`.

### Versions des SDK

#### SDK JavaScript

- [v2.59.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.59.0) - Ajout des méthodes `music.finetunes` pour lister, créer, récupérer, mettre à jour et supprimer des Music Finetunes. Ajout également de la résolution des références de conversations, du filtrage des dictionnaires de prononciation archivés et des jetons Speech to Text à usage unique.

#### SDK Python

- [v2.59.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.59.0) - Ajout des Music Finetunes et de la résolution des références de conversations à partir du dernier schéma API. `OnPremInitiationData` ajoute également les configurations typées `post_call_transcription_webhook` et `post_call_audio_webhook`, avec `hmac_secret` facultatif pour les webhooks signés après appel.

#### Packages

- [@elevenlabs/client@1.15.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.15.1) - Amélioration de la transmission des erreurs Scribe Realtime et du nettoyage du microphone lors d'échecs de configuration, de la fermeture par le client ou le serveur, et de trames audio tardives.
- [@elevenlabs/react@1.10.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.10.1), [@elevenlabs/react-native@1.2.15](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.15), [@elevenlabs/convai-widget-core@0.14.11](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.11) et [@elevenlabs/convai-widget-embed@0.14.11](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.11) - Mise à jour des dépendances pour inclure les correctifs Scribe Realtime de `@elevenlabs/client@1.15.1`.

#### SDK Android

- [v0.11.1](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.11.1) - Empêche R8 et ProGuard d'obfusquer les champs d'événements WebSocket et WebRTC sortants tels que `text` et `type`.

#### CLI

- [@elevenlabs/cli@0.5.6](https://github.com/elevenlabs/cli/releases/tag/%40elevenlabs%2Fcli%400.5.6) - Mise à jour des modèles d'agents par défaut afin d'utiliser `scribe_realtime` au lieu du fournisseur ASR `elevenlabs` supprimé. Les modèles minimaux continuent d'utiliser la valeur par défaut du serveur.

### API

<Accordion title="Voir les modifications de l'API">

## Nouveaux points de terminaison

### Musique

- [List Music Finetunes](/docs/fr/api-reference/music/finetunes/list) - `GET /v1/music/finetunes`
  - Prend en charge la pagination par curseur, les filtres de visibilité et de créateur, ainsi que le tri par date de création ou nom
- [Create Music Finetune](/docs/fr/api-reference/music/finetunes/create) - `POST /v1/music/finetunes`
  - Exige `name` et `primary_genre`
  - Accepte jusqu'à 50 fichiers audio, des balises, la visibilité et `model_id`
- [Get Music Finetune](/docs/fr/api-reference/music/finetunes/get) - `GET /v1/music/finetunes/{finetune_id}`
- [Update Music Finetune](/docs/fr/api-reference/music/finetunes/update) - `PATCH /v1/music/finetunes/{finetune_id}`
  - Met à jour `name`, `tags`, `primary_genre` ou `visibility`
- [Delete Music Finetune](/docs/fr/api-reference/music/finetunes/delete) - `DELETE /v1/music/finetunes/{finetune_id}`

### ElevenAgents

- `GET /v1/convai/conversations/resolve`
  - Exige les paramètres de requête `agent_id` (chaîne) et `reference` (chaîne)
  - Renvoie `GetConversationResponseModel`
- `POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query`
  - Exige `query` (chaîne) dans le corps de la requête
  - Accepte le paramètre de requête `branch_id` (chaîne) facultatif
  - Renvoie `AgentKnowledgeBaseRagQueryResponseModel`
  - Exclu des SDK générés

## Points de terminaison mis à jour

### ElevenAgents

- [Text search conversation messages](/docs/fr/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
  - Ajout des paramètres de requête de tableau `exclude_statuses` et `termination_reasons` facultatifs

### Speech to Text

- [Convert speech to text](/docs/fr/api-reference/speech-to-text/convert) - `POST /v1/speech-to-text`
  - Ajout du paramètre de requête `token` (chaîne) facultatif pour un jeton Scribe par lot à usage unique

### Text to Speech

- [List pronunciation dictionaries](/docs/fr/api-reference/pronunciation-dictionaries/list) - `GET /v1/pronunciation-dictionaries`
  - Ajout du paramètre de requête `include_archived` (booléen, `true` par défaut) facultatif

### Workspaces

- [Update workspace webhook](/docs/fr/api-reference/webhooks/update) - `PATCH /v1/workspace/webhooks/{webhook_id}`
  - Ajout du champ de requête `events` (`WorkspaceWebhookEventType[]`) facultatif
- [Get workspace usage](/docs/fr/api-reference/analytics/workspace/usage) - `POST /v1/workspace/analytics/query/usage-by-product-over-time`
  - Ajout de `surface` et `actor` au tableau `group_by` facultatif
- [Update service account API key](/docs/fr/api-reference/service-accounts/api-keys/update) - `PATCH /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id}`
  - Ajout de `"clear"` au champ `character_limit` facultatif

## Modifications des schémas

### ElevenAgents

- Les schémas de réponse de la base de connaissances ElevenAgents ajoutent `content_format` (`html` | `markdown`, `html` par défaut) facultatif
- Les réponses de fichiers de la base de connaissances ajoutent `auto_sync_info` et `refresh_status` (`FileRefreshStatus`) facultatifs
- Les réponses de dossiers de la base de connaissances ajoutent `document_count` (entier) obligatoire
- Les schémas de remplacement TTS de l'agent ajoutent `model_id` (`TTSConversationalModel`) facultatif
- `enable_phoneme_tags` du TTS de l'agent a désormais `true` comme valeur par défaut au lieu de `false`
- `cascade_timeout_seconds` du LLM de secours a désormais 4 secondes comme valeur par défaut au lieu de 8
- La configuration LLM de l'agent ajoute `gpt-5.6-sol`, `gpt-5.6-terra` et `gpt-5.6-luna` ; `LLMReasoningEffort` ajoute `max`
- Les garde-fous personnalisés ajoutent `evaluate_full_response_only` (booléen, `false` par défaut) facultatif
- La configuration des appels de téléphonie ajoute `twilio_call_recording_enabled` (booléen, `false` par défaut) facultatif
- Les paramètres d'outil objet ajoutent `dynamic_variable`, `constant_value` et `is_omitted` ; les remplacements constants acceptent des valeurs de tableaux et d'objets arbitraires
- La configuration de texte du widget ajoute des libellés facultatifs d'importation de fichiers et d'indicateur de saisie
- Les schémas de compte WhatsApp ajoutent `enable_typing_indicator` (booléen) facultatif
- Les schémas de simulation et de test ajoutent `AutoGenerationMetadata` et `SimulationLibrarySettings`

### Musique

- Ajout des schémas de requête, réponse, pagination, visibilité, créateur, statut et motif d'échec pour Music Finetune
- Tous les schémas de requête de génération musicale exposent `finetune_id` aux SDK générés

### Workspaces

- Les schémas de requête et de réponse des webhooks de Workspace ajoutent `events` (`WorkspaceWebhookEventType[]`) facultatif
- Les schémas de notificateur webhook d'alerte utilisent `webhook_id` (chaîne) obligatoire au lieu de `url`, `method` et `headers`

</Accordion>