Changelog

ElevenAgents

• 分支变基：新增 POST /v1/convai/agents/{agent_id}/branches/{branch_id}/rebase，可将分支变基到最新 main，同时保留分支特有的更改。智能体版本父模型新增可选 rebased_from_version_id（字符串），用于在变基后追踪源版本。
• 对话产品筛选：列出对话 和 文本搜索对话消息 新增可选 conversation_product_type 查询参数（agents | speech_engine），可按产品筛选结果。对话模型新增 ConversationProduct 以区分产品。
• 对话终止筛选：列出对话 新增可选 termination_reasons 查询参数（字符串数组），可按对话结束方式筛选。
• 按智能体进行主题发现：创建智能体 和 更新智能体 的平台设置新增可选 topic_discovery（TopicDiscoverySettings），用于配置每个智能体的主题发现。
• 背景音配置：智能体平台和对话配置模型新增可选 background_sound（BackgroundSoundConfig），用于在对话期间播放环境音频。
• 轮次中断忽略词：轮次配置架构新增可选 interruption_ignore_terms（字符串数组），可针对特定短语禁用轮次检测。
• 软超时填充内容随机化：软超时配置新增可选 randomize_fillers（布尔值），可在多次软超时中随机排列填充消息。软超时消息和 LLM 提示词覆盖字段现已支持动态变量。
• 转录用户标识符：转录消息模型在用户创建的消息中新增可选 user_identifier（字符串）。
• 模拟成功条件：智能体模拟测试架构新增可选 success_conditions（数组，最多 30 项）。旧版 success_condition 字段已弃用，改用数组形式。
• 智能体测试重复上限：在智能体上运行测试 将 repeat_count 最大值从 20 提升至 50。
• 工具架构动态允许值：ElevenAgents 工具 JSON 架构属性新增可选 allowed_values_dynamic_variable（字符串），用于从动态变量获取经服务器验证的 LLM 值选择。
• 小组件签名 URL 文档：获取小组件 更新了 conversation_signature 文档，引用 /v1/convai/conversation/get_signed_url。

音乐

• 更高质量的输出格式：生成音乐、生成详细音乐 和 流式生成音乐 在支持的 output_format 值中新增 mp3_48000_240 和 mp3_48000_320。当 output_format 为 auto 时，v2 模型现默认使用 mp3_48000_192，而非 mp3_48000_128。
• 段落时长标记说明：respect_sections_durations 仅适用于 music_v1 的 composition_plan。在 music_v2 中，段落时长始终会被强制执行，该标记将被忽略。
• 创作计划架构拆分：音乐请求的 composition_plan 使用由 MusicPrompt 和 CompositionPlan 组成的 oneOf 联合类型。前者用于 music_v1 创作计划，后者用于 music_v2。

配音

• 项目列表筛选：列出配音项目 新增可选 dubbing_statuses、dubbing_models、target_language_codes 和 creation_sources 数组查询参数，用于筛选列表。order_by 参数现除 created_at 外还接受 name。

工作区

• 锁定和禁用原因：工作区和 API 密钥模型新增 LockReason 和可选 disable_reason 字段。工作区组设置新增可选 scim_frozen（布尔值），用于表示由 SCIM 管理的冻结状态。

ElevenCreative Studio

• 字幕动画：Studio 字幕进入和退出动画枚举新增 pop、slide_up 和 slide_down。

SDK 发布

JavaScript SDK

• v2.54.0 - 根据最新 OpenAPI 架构重新生成，支持分支变基客户端、对话列表和文本搜索的 conversation_product_type 及 termination_reasons 筛选、配音列表多值筛选、音乐专用 output_format 类型、主题发现设置，并移除了与辅导相关的导出类型。
• v2.53.1 - 恢复了在 v2.53.0 中被错误收窄的 DynamicVariablesConfig 记录中的可选值。

Python SDK

• v2.54.0 - 根据最新 OpenAPI 架构重新生成，支持分支变基客户端、对话列表和文本搜索筛选、配音列表多值筛选、音乐输出格式更新、主题发现设置，并移除了与辅导相关的导出类型。ElevenLabs 和 AsyncElevenLabs 现接受传递至基础客户端的 headers 和 follow_redirects。

软件包

• @elevenlabs/client@1.12.0 - 为浏览器客户端新增 overrides.asr.keywords 支持，因此可通过 conversation_initiation_client_data 发送每次对话的 ASR 关键词偏置。
• @elevenlabs/react@1.7.0 - 为实时 Scribe 会话公开 includeLanguageDetection，包括 React useScribe 对请求和读取检测语言元数据的支持。
• @elevenlabs/react-native@1.2.9、@elevenlabs/types@0.15.0、@elevenlabs/convai-widget-core@0.14.4 和 @elevenlabs/convai-widget-embed@0.14.4 - 依赖项与 @elevenlabs/client@1.12.0 和 @elevenlabs/types@0.15.0 对齐。
• @elevenlabs/client@1.12.1 - 从内部 Unity 入口点公开文件上传辅助工具。
• @elevenlabs/react@1.7.1、@elevenlabs/react-native@1.2.10、@elevenlabs/convai-widget-core@0.14.5 和 @elevenlabs/convai-widget-embed@0.14.5 - 依赖项与 @elevenlabs/client@1.12.1 对齐。

MCP 服务器

• v0.10.0 - 新增 Music v2 模型和端点、全部 24 个工具的 MCP 工具注释、Python 3.14 支持、新加坡数据驻留、EU/IN 驻留简写别名、客户端断开连接时的优雅关闭处理，以及语音预览创建和输出目录路径解析修复。

API