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-lite o gemini-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 incluyen whatsapp_phone_number_id, whatsapp_user_id, template_name, template_language_code, template_params y agent_id.
  • Modelo conversacional Eleven v3: Se ha añadido eleven_v3_conversational a 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_tags a 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_mode a 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) u hide (no comparte el error con el agente).
  • Saneamiento de variables dinámicas: Se ha añadido el campo sanitize (booleano, valor predeterminado false) a DynamicVariableAssignment. 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 TurnModel con las opciones turn_v2 y turn_v3 para 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 predeterminado false) al esquema AgentTransfer para identificar transferencias dentro de nodos de workflow.
  • Metadatos de ramas de transferencia: Se han añadido los esquemas TransferBranchInfoTrafficSplit y TransferBranchInfoDefaultingToMain para 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_transition para pruebas unitarias con el esquema UnitTestWorkflowNodeTransitionEvaluationNodeId para 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_member al enum SeatType para espacios de trabajo con permisos de acceso limitados.
  • Recurso de plantillas de contenido: Se ha añadido content_templates al enum WorkspaceResourceType para 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 textOnly entre 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

Nuevas rutas

Rutas actualizadas

Plataforma de Agents

  • Crear agente, Actualizar agente, Obtener agente
    • Se ha añadido el campo custom al esquema GuardrailsV1 para la configuración de medidas de seguridad personalizadas
    • Se ha añadido el campo alignment al esquema GuardrailsV1 para las medidas de seguridad de alineación
    • Se ha añadido el campo suggested_audio_tags a la configuración conversacional de TTS (array de SuggestedAudioTag, máximo 20 elementos)
    • Se ha añadido eleven_v3_conversational al enum TTSConversationalModel
  • Crear herramienta, Actualizar herramienta
    • Se ha añadido el campo tool_error_handling_mode a ApiIntegrationWebhookToolConfig (enum: auto, summarized, passthrough, hide; valor predeterminado auto)
    • Se ha añadido el campo sanitize a DynamicVariableAssignment (booleano, valor predeterminado false)

Espacios de trabajo

Cambios en esquemas

Nuevos esquemas

  • CustomGuardrail-Input, CustomGuardrail-Output - Contenedor para la configuración de medidas de seguridad personalizadas
  • CustomGuardrailsConfig - Contenedor de configuración para la lista de medidas de seguridad personalizadas
  • CustomGuardrailConfig - Medida de seguridad personalizada individual con name (cadena, obligatorio), prompt (cadena, obligatorio, máximo 10.000 caracteres), model (enum: gemini-2.5-flash-lite, gemini-2.0-flash, obligatorio) e is_enabled (booleano, valor predeterminado false)
  • ToolErrorHandlingMode - Enum para la gestión de errores de herramientas: auto, summarized, passthrough, hide
  • TurnModel - Enum para la versión del modelo de detección de turnos: turn_v2, turn_v3
  • SuggestedAudioTag - Configuración de etiqueta de audio con tag (cadena, obligatorio, máximo 30 caracteres) y description (cadena, opcional, máximo 200 caracteres)
  • TransferBranchInfoTrafficSplit - Información de rama para transferencias con división de tráfico, con branch_id y traffic_percentage
  • TransferBranchInfoDefaultingToMain - Información de rama para transferencias predeterminadas a la principal, con branch_id
  • UnitTestWorkflowNodeTransitionEvaluationNodeId - Configuración de prueba de transición de nodos de workflow con agent_id y target_node_id
  • ProjectMutedTracksResponseModel - Modelo de respuesta con el array chapter_ids
  • WhatsAppOutboundMessageResponse - Respuesta para la ruta de mensajes salientes de WhatsApp
  • WhatsAppTemplateHeaderComponentParams, WhatsAppTemplateBodyComponentParams, WhatsAppTemplateButtonComponentParams - Esquemas de parámetros de plantilla para mensajes de WhatsApp
  • ConversationHistoryTranscriptSystemToolResultCommonModel-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 campos custom (CustomGuardrail) y alignment (AlignmentGuardrail)
  • TTSConversationalConfig-Input, TTSConversationalConfig-Output - Se ha añadido el campo suggested_audio_tags
  • TTSConversationalModel - Se ha añadido el valor de enum eleven_v3_conversational
  • ApiIntegrationWebhookToolConfig-Input, ApiIntegrationWebhookToolConfig-Output - Se ha añadido el campo tool_error_handling_mode (obligatorio)
  • DynamicVariableAssignment - Se ha añadido el campo sanitize (booleano, valor predeterminado false)
  • AgentTransfer - Se ha añadido el campo is_workflow_node_transfer (booleano, valor predeterminado false)
  • SeatType - Se ha añadido el valor de enum workspace_lite_member
  • WorkspaceResourceType - Se ha añadido el valor de enum content_templates

Esquemas eliminados

  • AgentBan - Se ha eliminado el esquema sin usar
  • BanReasonType - Se ha eliminado el enum sin usar
  • DubbingReleaseChannel - Se ha eliminado el enum sin usar