ElevenAgents, ElevenCreative y ElevenAPI
Estamos pasando de la percepción de un único producto («ElevenLabs») a una estructura basada en plataformas con familias de productos claramente definidas:
- ElevenAgents (antes Plataforma de Agents)
- ElevenCreative (antes Plataforma Creativa)
- ElevenAPI (nueva, la Plataforma para desarrolladores)
Ya verás estos cambios reflejados en la documentación y los readmes de los SDK.
Servidores globales salen de beta
El enrutamiento global ahora es la opción predeterminada, en lugar de una opción voluntaria.
Antes, el servidor predeterminado de la API de ElevenLabs se encontraba en Estados Unidos, con una beta opcional para enrutar el tráfico a través de servidores ubicados en Países Bajos o Singapur. A partir de ahora, el enrutamiento global es la opción predeterminada, lo que significa que el servidor se elegirá automáticamente según la proximidad geográfica para optimizar la latencia.
La URL base opcional api-global-preview.elevenlabs.io ha quedado obsoleta; utiliza en su lugar la URL base predeterminada api.elevenlabs.io. Si utilizas los SDK, ya es la opción predeterminada.
Texto a Voz
- Normalizador TTS v3.1: Se ha actualizado el normalizador de texto a la versión 3.1, que incluye mayor precisión y menor latencia para la conversión de texto a voz.
Plataforma de Agents
- Medidas de seguridad personalizadas: Se ha añadido compatibilidad con medidas de seguridad de salida definidas por usuarios que te permiten crear reglas personalizadas de filtrado de contenido más allá de la moderación estándar. Configura las medidas de seguridad con un nombre, una instrucción de prompt (hasta 10.000 caracteres) y el modelo de evaluación (
gemini-2.5-flash-liteogemini-2.0-flash). Cuando se activa, la medida de seguridad finaliza la conversación. Consulta la referencia de la API Crear agente para ver los detalles de configuración. - Mensajería saliente de WhatsApp: Se ha añadido la ruta Enviar mensaje saliente (
POST /v1/convai/whatsapp/outbound-message) para iniciar conversaciones por WhatsApp mediante plantillas de mensajes. Los campos obligatorios incluyenwhatsapp_phone_number_id,whatsapp_user_id,template_name,template_language_code,template_paramsyagent_id. - Modelo conversacional Eleven v3: Se ha añadido
eleven_v3_conversationala los modelos TTS disponibles para agentes, lo que proporciona mejor calidad de voz y expresividad en las conversaciones de agentes. - Etiquetas de audio sugeridas: Se ha añadido el campo
suggested_audio_tagsa la configuración TTS para agentes que usan modelos v3. Define hasta 20 etiquetas (por ejemplo, “happy”, “excited”) para guiar la generación de voz expresiva, con descripciones opcionales que indican cuándo debe usarse cada etiqueta. - Gestión de errores de herramientas: Se ha añadido el campo
tool_error_handling_modea las configuraciones de herramientas de webhook con las opciones:auto(predeterminado; determina la gestión según el tipo de herramienta),summarized(envía un resumen generado por LLM),passthrough(envía el error sin procesar) uhide(no comparte el error con el agente). - Saneamiento de variables dinámicas: Se ha añadido el campo
sanitize(booleano, valor predeterminadofalse) aDynamicVariableAssignment. Cuando está activado, el valor asignado se elimina de las respuestas de herramientas y las transcripciones, aunque sigue procesándose para la asignación de variables. - Selección de modelo de turnos: Se ha añadido el enum
TurnModelcon las opcionesturn_v2yturn_v3para seleccionar la versión del modelo de detección de turnos. - Transferencias de nodos de workflow: Se ha añadido el campo
is_workflow_node_transfer(booleano, valor predeterminadofalse) al esquemaAgentTransferpara identificar transferencias dentro de nodos de workflow. - Metadatos de ramas de transferencia: Se han añadido los esquemas
TransferBranchInfoTrafficSplityTransferBranchInfoDefaultingToMainpara realizar el seguimiento de la información de enrutamiento de ramas en las transferencias de agentes. - Pruebas de transiciones de nodos de workflow: Se ha añadido el tipo de aserción
workflow_node_transitionpara pruebas unitarias con el esquemaUnitTestWorkflowNodeTransitionEvaluationNodeIdpara validar transiciones de workflow de agentes.
Studio de ElevenCreative
- Ruta de pistas silenciadas: Se ha añadido la ruta Obtener pistas silenciadas del proyecto (
GET /v1/studio/projects/{project_id}/muted-tracks), que devuelve una lista de ID de capítulos con pistas silenciadas en un proyecto.
Espacios de trabajo
- Tipo de puesto de miembro Lite: Se ha añadido
workspace_lite_memberal enumSeatTypepara espacios de trabajo con permisos de acceso limitados. - Recurso de plantillas de contenido: Se ha añadido
content_templatesal enumWorkspaceResourceTypepara compartir plantillas de contenido en espacios de trabajo.
Interfaz de usuario
- Desplazamiento en colecciones de voces: Se ha corregido un problema que impedía el desplazamiento con la rueda del ratón y el táctil en el selector de iconos de colecciones de voces en macOS.
Lanzamientos de SDK
SDK de Python
- v2.35.0 - Se han añadido medidas de seguridad personalizadas, mensajería saliente de WhatsApp, modo de gestión de errores de herramientas, saneamiento de variables dinámicas, selección de modelo de turnos y compatibilidad con el modelo conversacional Eleven v3
SDK de JavaScript
- v2.35.0 - Se han añadido medidas de seguridad personalizadas, mensajería saliente de WhatsApp, modo de gestión de errores de herramientas, saneamiento de variables dinámicas, selección de modelo de turnos y compatibilidad con el modelo conversacional Eleven v3
SDK de React y Client
- @elevenlabs/react-native@0.5.10 - Se ha corregido el establecimiento de conversaciones solo de texto
- @elevenlabs/react@0.14.0 - Se ha reducido la duración de los fragmentos de audio de 250 ms a 100 ms para reducir la latencia en las conversaciones de agentes
- @elevenlabs/client@0.14.0 - Se ha reducido la duración de los fragmentos de audio de 250 ms a 100 ms para reducir la latencia y se ha normalizado la gestión de la opción
textOnlyentre el nivel superior y el objeto de anulaciones - @elevenlabs/types@0.5.0 - Se han añadido tipos para compatibilidad con datos de alineación de audio
API
Ver cambios de la API
Nuevas rutas
- Enviar mensaje saliente por WhatsApp -
POST /v1/convai/whatsapp/outbound-message- Envía un mensaje saliente por WhatsApp mediante plantillas de mensajes - Obtener pistas silenciadas del proyecto -
GET /v1/studio/projects/{project_id}/muted-tracks- Devuelve ID de capítulos con pistas silenciadas
Rutas actualizadas
Plataforma de Agents
- Crear agente, Actualizar agente, Obtener agente
- Se ha añadido el campo
customal esquemaGuardrailsV1para la configuración de medidas de seguridad personalizadas - Se ha añadido el campo
alignmental esquemaGuardrailsV1para las medidas de seguridad de alineación - Se ha añadido el campo
suggested_audio_tagsa la configuración conversacional de TTS (array deSuggestedAudioTag, máximo 20 elementos) - Se ha añadido
eleven_v3_conversationalal enumTTSConversationalModel
- Se ha añadido el campo
- Crear herramienta, Actualizar herramienta
- Se ha añadido el campo
tool_error_handling_modeaApiIntegrationWebhookToolConfig(enum:auto,summarized,passthrough,hide; valor predeterminadoauto) - Se ha añadido el campo
sanitizeaDynamicVariableAssignment(booleano, valor predeterminadofalse)
- Se ha añadido el campo
Espacios de trabajo
- Obtener recurso
- Se ha añadido
content_templatesal enumWorkspaceResourceType
- Se ha añadido
- Añadir invitación al espacio de trabajo, Añadir miembro al espacio de trabajo
- Se ha añadido
workspace_lite_memberal enumSeatType
- Se ha añadido
Cambios en esquemas
Nuevos esquemas
CustomGuardrail-Input,CustomGuardrail-Output- Contenedor para la configuración de medidas de seguridad personalizadasCustomGuardrailsConfig- Contenedor de configuración para la lista de medidas de seguridad personalizadasCustomGuardrailConfig- Medida de seguridad personalizada individual conname(cadena, obligatorio),prompt(cadena, obligatorio, máximo 10.000 caracteres),model(enum:gemini-2.5-flash-lite,gemini-2.0-flash, obligatorio) eis_enabled(booleano, valor predeterminadofalse)ToolErrorHandlingMode- Enum para la gestión de errores de herramientas:auto,summarized,passthrough,hideTurnModel- Enum para la versión del modelo de detección de turnos:turn_v2,turn_v3SuggestedAudioTag- Configuración de etiqueta de audio contag(cadena, obligatorio, máximo 30 caracteres) ydescription(cadena, opcional, máximo 200 caracteres)TransferBranchInfoTrafficSplit- Información de rama para transferencias con división de tráfico, conbranch_idytraffic_percentageTransferBranchInfoDefaultingToMain- Información de rama para transferencias predeterminadas a la principal, conbranch_idUnitTestWorkflowNodeTransitionEvaluationNodeId- Configuración de prueba de transición de nodos de workflow conagent_idytarget_node_idProjectMutedTracksResponseModel- Modelo de respuesta con el arraychapter_idsWhatsAppOutboundMessageResponse- Respuesta para la ruta de mensajes salientes de WhatsAppWhatsAppTemplateHeaderComponentParams,WhatsAppTemplateBodyComponentParams,WhatsAppTemplateButtonComponentParams- Esquemas de parámetros de plantilla para mensajes de WhatsAppConversationHistoryTranscriptSystemToolResultCommonModel-Input,ConversationHistoryTranscriptSystemToolResultCommonModel-Output- Modelos de resultado de herramienta de sistema divididos para variantes de entrada y salida
Esquemas modificados
GuardrailsV1-Input,GuardrailsV1-Output- Se han añadido los camposcustom(CustomGuardrail) yalignment(AlignmentGuardrail)TTSConversationalConfig-Input,TTSConversationalConfig-Output- Se ha añadido el camposuggested_audio_tagsTTSConversationalModel- Se ha añadido el valor de enumeleven_v3_conversationalApiIntegrationWebhookToolConfig-Input,ApiIntegrationWebhookToolConfig-Output- Se ha añadido el campotool_error_handling_mode(obligatorio)DynamicVariableAssignment- Se ha añadido el camposanitize(booleano, valor predeterminadofalse)AgentTransfer- Se ha añadido el campois_workflow_node_transfer(booleano, valor predeterminadofalse)SeatType- Se ha añadido el valor de enumworkspace_lite_memberWorkspaceResourceType- Se ha añadido el valor de enumcontent_templates
Esquemas eliminados
AgentBan- Se ha eliminado el esquema sin usarBanReasonType- Se ha eliminado el enum sin usarDubbingReleaseChannel- Se ha eliminado el enum sin usar