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

### ElevenAgents

- **Rebase de ramas**: Se ha añadido `POST /v1/convai/agents/{agent_id}/branches/{branch_id}/rebase` para aplicar el rebase de una rama sobre la última versión principal, conservando los cambios específicos de la rama. Los modelos principales de versiones de agentes añaden `rebased_from_version_id` (cadena) opcional para registrar la versión de origen después de un rebase.
- **Filtrado de conversaciones por producto**: [Listar conversaciones](/docs/es/api-reference/conversations/list) y [Buscar texto en mensajes de conversaciones](/docs/es/api-reference/conversations/messages/text-search) añaden el parámetro de consulta opcional `conversation_product_type` (`agents` | `speech_engine`) para filtrar resultados por producto. Los modelos de conversación incorporan `ConversationProduct` para esta distinción.
- **Filtrado por finalización de conversación**: [Listar conversaciones](/docs/es/api-reference/conversations/list) añade el parámetro de consulta opcional `termination_reasons` (matriz de cadenas) para filtrar conversaciones según cómo terminaron.
- **Descubrimiento de temas por agente**: La configuración de plataforma de [Crear agente](/docs/es/api-reference/agents/create) y [Actualizar agente](/docs/es/api-reference/agents/update) añade `topic_discovery` (`TopicDiscoverySettings`) opcional para configurar el descubrimiento de temas por agente.
- **Configuración de sonido de fondo**: Los modelos de configuración de plataforma y conversación de agentes añaden `background_sound` (`BackgroundSoundConfig`) opcional para el audio ambiental durante las conversaciones.
- **Términos que se ignoran en la interrupción de turnos**: Los esquemas de configuración de turnos añaden `interruption_ignore_terms` (matriz de cadenas) opcional para omitir la detección de turnos en frases específicas.
- **Aleatorización de mensajes de relleno en tiempos de espera flexibles**: La configuración de tiempo de espera flexible añade `randomize_fillers` (booleano) opcional para alternar los mensajes de relleno entre tiempos de espera flexibles. Los campos de mensajes de tiempo de espera flexible y de anulación de prompts de LLM ahora admiten variables dinámicas.
- **Identificadores de usuario en transcripciones**: Los modelos de mensajes de transcripción añaden `user_identifier` (cadena) opcional en los mensajes creados por usuarios.
- **Condiciones de éxito de simulaciones**: Los esquemas de pruebas de simulación de agentes añaden `success_conditions` (matriz, hasta 30 elementos) opcional. El campo heredado `success_condition` queda obsoleto en favor de la forma de matriz.
- **Límite de repeticiones de pruebas de agentes**: [Ejecutar pruebas en el agente](/docs/es/api-reference/tests/run-tests) aumenta el valor máximo de `repeat_count` de 20 a 50.
- **Valores permitidos dinámicos en el esquema de herramientas**: Las propiedades del esquema JSON de herramientas de ElevenAgents añaden `allowed_values_dynamic_variable` (cadena) opcional para selecciones de valores de LLM verificadas por el servidor y obtenidas de variables dinámicas.
- **Documentación de URL firmada del widget**: [Obtener widget](/docs/es/api-reference/widget/get) actualiza la documentación de `conversation_signature` para hacer referencia a `/v1/convai/conversation/get_signed_url`.

### Música

- **Formatos de salida de mayor calidad**: [Generar música](/docs/es/api-reference/music/compose), [Generar música detallada](/docs/es/api-reference/music/compose-detailed) y [Transmitir música](/docs/es/api-reference/music/stream) añaden `mp3_48000_240` y `mp3_48000_320` a los valores compatibles de `output_format`. Cuando `output_format` es `auto`, los modelos v2 ahora usan `mp3_48000_192` de forma predeterminada en lugar de `mp3_48000_128`.
- **Aclaración sobre la marca de duración de secciones**: `respect_sections_durations` solo se aplica con `composition_plan` en `music_v1`. En `music_v2`, las duraciones de las secciones siempre se respetan y esta marca se ignora.
- **División del esquema de plan de composición**: El `composition_plan` de las solicitudes de música usa una unión `oneOf` de `MusicPrompt` y `CompositionPlan`. El primero se usa para planes de composición de `music_v1` y el segundo para `music_v2`.

### Doblaje IA

- **Filtros de lista de proyectos**: [Listar doblajes](/docs/es/api-reference/dubbing/list) añade los parámetros de consulta de matriz opcionales `dubbing_statuses`, `dubbing_models`, `target_language_codes` y `creation_sources` para filtrar la lista. El parámetro `order_by` ahora acepta `name` además de `created_at`.

### Espacios de trabajo

- **Motivos de bloqueo y desactivación**: Los modelos de espacio de trabajo y de clave de API añaden `LockReason` y los campos opcionales `disable_reason`. La configuración de grupos de espacios de trabajo añade `scim_frozen` (booleano) opcional para el estado de congelación gestionado por SCIM.

### ElevenCreative Studio

- **Animaciones de subtítulos**: Las enumeraciones de animación de entrada y salida de subtítulos de Studio añaden `pop`, `slide_up` y `slide_down`.

### Lanzamientos de SDK

#### SDK de JavaScript

- [v2.54.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.54.0) - Regenerado a partir del esquema OpenAPI más reciente con compatibilidad de cliente para rebase de ramas, filtros `conversation_product_type` y `termination_reasons` para lista y búsqueda de texto de conversaciones, filtros multivalor para la lista de doblajes, tipos de `output_format` específicos de música, configuración de descubrimiento de temas y eliminación de tipos exportados relacionados con coaching.
- [v2.53.1](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.53.1) - Se restauraron los valores opcionales en los registros `DynamicVariablesConfig` que se restringieron incorrectamente en v2.53.0.

#### SDK de Python

- [v2.54.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.54.0) - Regenerado a partir del esquema OpenAPI más reciente con compatibilidad de cliente para rebase de ramas, filtros para lista y búsqueda de texto de conversaciones, filtros multivalor para la lista de doblajes, actualizaciones de formato de salida de música, configuración de descubrimiento de temas y eliminación de tipos exportados relacionados con coaching. `ElevenLabs` y `AsyncElevenLabs` ahora aceptan la transferencia de `headers` y `follow_redirects` al cliente base.

#### Paquetes

- [@elevenlabs/client@1.12.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.12.0) - Se ha añadido compatibilidad con `overrides.asr.keywords` en el cliente de navegador para poder enviar la ponderación de palabras clave de ASR por conversación mediante `conversation_initiation_client_data`.
- [@elevenlabs/react@1.7.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.7.0) - Se ha expuesto `includeLanguageDetection` para sesiones de Scribe en tiempo real, incluida la compatibilidad de React `useScribe` para solicitar y leer metadatos del idioma detectado.
- [@elevenlabs/react-native@1.2.9](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.9), [@elevenlabs/types@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.15.0), [@elevenlabs/convai-widget-core@0.14.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.4) y [@elevenlabs/convai-widget-embed@0.14.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.4) - Alineación de dependencias con `@elevenlabs/client@1.12.0` y `@elevenlabs/types@0.15.0`.
- [@elevenlabs/client@1.12.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.12.1) - Se ha expuesto el asistente de carga de archivos desde el punto de entrada interno de Unity.
- [@elevenlabs/react@1.7.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.7.1), [@elevenlabs/react-native@1.2.10](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.10), [@elevenlabs/convai-widget-core@0.14.5](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.5) y [@elevenlabs/convai-widget-embed@0.14.5](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.5) - Alineación de dependencias con `@elevenlabs/client@1.12.1`.

#### Servidor MCP

- [v0.10.0](https://github.com/elevenlabs/elevenlabs-mcp/releases/tag/v0.10.0) - Se han añadido el modelo Music v2 y las rutas de API, anotaciones de herramientas MCP para las 24 herramientas, compatibilidad con Python 3.14, residencia de datos en Singapur, alias abreviados de residencia en la UE/IN, gestión de apagado ordenado ante desconexiones de clientes y correcciones para la creación de previsualizaciones de voz y la resolución de rutas de directorios de salida.

### API

<Accordion title="Ver cambios de la API">

## Nuevas rutas de API

### ElevenAgents

- `POST /v1/convai/agents/{agent_id}/branches/{branch_id}/rebase` - Aplica el rebase de una rama sobre la última versión principal, conservando los cambios específicos de la rama

## Rutas de API actualizadas

### ElevenAgents

- [Listar conversaciones](/docs/es/api-reference/conversations/list) - `GET /v1/convai/conversations`
  - Se ha añadido el parámetro de consulta opcional `conversation_product_type` (`agents` | `speech_engine`)
  - Se ha añadido el parámetro de consulta opcional `termination_reasons` (matriz de cadenas)
- [Buscar texto en mensajes de conversaciones](/docs/es/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
  - Se ha añadido el parámetro de consulta opcional `conversation_product_type` (`agents` | `speech_engine`)
- [Obtener widget](/docs/es/api-reference/widget/get) - `GET /v1/convai/agents/{agent_id}/widget`
  - Se ha actualizado la documentación de `conversation_signature` para hacer referencia a `/v1/convai/conversation/get_signed_url`
- [Ejecutar pruebas en el agente](/docs/es/api-reference/tests/run-tests) - `POST /v1/convai/agents/{agent_id}/run-tests`
  - Se ha aumentado el máximo de `repeat_count` de 20 a 50

### Doblaje IA

- [Listar doblajes](/docs/es/api-reference/dubbing/list) - `GET /v1/dubbing`
  - Se han añadido los parámetros de consulta opcionales `dubbing_statuses`, `dubbing_models`, `target_language_codes` y `creation_sources`
  - `order_by` ahora acepta `name` además de `created_at`

### Música

- [Generar música](/docs/es/api-reference/music/compose), [Generar música detallada](/docs/es/api-reference/music/compose-detailed) y [Transmitir música](/docs/es/api-reference/music/stream)
  - Se han añadido `mp3_48000_240` y `mp3_48000_320` a los valores compatibles de `output_format`
  - El formato de salida `auto` selecciona `mp3_48000_192` para los modelos v2 (antes `mp3_48000_128`)

## Cambios en los esquemas

### ElevenAgents

- Ramas y versiones de agentes
  - Se ha añadido `rebased_from_version_id` opcional en los modelos principales de versiones de agentes
- Configuración de plataforma y conversación
  - Se ha añadido `topic_discovery` (`TopicDiscoverySettings`) opcional en los modelos de solicitud y respuesta de configuración de plataforma
  - Se ha añadido `background_sound` (`BackgroundSoundConfig`) opcional
- Configuración de turnos y tiempos de espera
  - Se ha añadido `interruption_ignore_terms` (matriz de cadenas) opcional en los esquemas de configuración de turnos
  - Se ha añadido `randomize_fillers` (booleano) opcional en la configuración de tiempo de espera flexible
- Transcripciones y simulación
  - Se ha añadido `user_identifier` (cadena) opcional en los mensajes de usuarios de transcripciones
  - Se ha añadido `success_conditions` (matriz, máximo 30); `success_condition` queda obsoleto
- Propiedades del esquema JSON de herramientas
  - Se ha añadido `allowed_values_dynamic_variable` (cadena) opcional

### Música

- Planes de composición
  - El campo de solicitud `composition_plan` usa `oneOf` (`MusicPrompt` | `CompositionPlan`)
  - Se ha aclarado el comportamiento de `respect_sections_durations` para `music_v1` frente a `music_v2`

### Espacios de trabajo

- Se han añadido la enumeración `LockReason` y los campos opcionales `disable_reason`
- Se ha añadido `scim_frozen` (booleano) opcional en la configuración de grupos de espacios de trabajo

### ElevenCreative Studio

- Las enumeraciones de animación de subtítulos añaden `pop`, `slide_up` y `slide_down`

## Esquemas eliminados

### ElevenAgents

- Se han eliminado los esquemas de configuración relacionados con coaching (`CoachedAgentSettings`, `CoachingAgentSettings`, `NoCoachingSettings`)

</Accordion>