Changelog

音乐

• Music Finetunes API：新增用于管理 Music Finetunes 的 API 支持。5 个端点可让你通过上传的音频创建 Finetune、列出可访问的 Finetune、获取训练状态、更新元数据和可见性，或删除 Finetune。现在所有音乐生成 SDK 方法都提供 finetune_id。

ElevenAgents

• 解析外部对话引用：新增 GET /v1/convai/conversations/resolve，可将 Slack 消息 URL 或 Zendesk 工单 URL 解析为对话。请求需要 agent_id 和 reference 查询参数（字符串）。
• 查询智能体知识库：新增 POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query，用于对智能体知识库执行只读 RAG 查询。请求需要 query（字符串），接受可选 branch_id（字符串），并返回按排名排列的分块及文档、分块、文本和向量距离元数据。此端点不包含在生成的 SDK 中。
• 知识库内容格式：知识库文件、文本和 URL 响应新增可选 content_format（html | markdown，默认 html）。
• 智能体语音配置：TTS 覆盖架构新增可由客户端覆盖的可选 model_id（TTSConversationalModel）。enable_phoneme_tags 默认值从 false 改为 true。
• 更快的备用 LLM 级联：默认 cascade_timeout_seconds 从 8 秒改为 4 秒。允许范围仍为 2–15 秒。
• 工具参数值来源：对象工具参数现在可使用 dynamic_variable、constant_value 或 is_omitted，与现有标量和数组控件保持一致。常量架构覆盖现在支持任意数组和对象。
• 完整响应护栏：自定义护栏新增可选 evaluate_full_response_only（布尔值，默认 false），用于仅对完整的非 TTS 响应评估一次。此选项需要阻止模式。
• Twilio 通话录音：电话通信通话配置新增可选 twilio_call_recording_enabled（布尔值，默认 false）。录音存储在已连接的 Twilio 账户中，其他提供商会忽略此设置。
• 小组件文件上传文本：小组件文本配置新增可选标签和错误消息，用于附加和移除文件、上传失败、不支持的类型、超大文件、文件数量限制及输入指示器。
• 知识库同步状态：知识库文件响应新增可选 auto_sync_info 和 refresh_status（FileRefreshStatus）。文件夹响应新增必填 document_count（整数），即非文件夹文档的递归计数，上限为 1000。
• 对话文本搜索筛选条件：文本搜索对话消息 新增可选 exclude_statuses 和 termination_reasons 数组查询参数。
• LLM 选项：智能体 LLM 配置新增 gpt-5.6-sol、gpt-5.6-terra 和 gpt-5.6-luna。LLMReasoningEffort 新增 max。
• WhatsApp 输入指示器：WhatsApp 账户请求和响应架构新增可选 enable_typing_indicator（布尔值）。

语音转文本

• 单次批处理身份验证：将语音转换为文本 新增可选 token（字符串），可替代 API 密钥或 Bearer 身份验证。使用 POST /v1/single-use-token/batch_scribe 创建单次令牌；其将在 15 分钟后过期。
• 实时客户端可靠性：@elevenlabs/client 现在会通过 RealtimeEvents.ERROR 报告麦克风设置和服务器格式错误，设置失败和连接关闭后会释放麦克风资源，并在套接字拆除后丢弃延迟到达的麦克风帧。

文本转语音

• 已归档发音词典：列出发音词典 新增可选 include_archived（布尔值，默认 true）。

工作区

• Webhook 事件订阅：更新工作区 Webhook 请求新增可选 events（WorkspaceWebhookEventType[]），包含 voice_library_removal_notice、speech_to_text 和 agent_qa。Webhook 响应可返回已订阅的事件列表。
• 用量分析维度：获取工作区用量 在 group_by 值中新增 surface 和 actor。
• 清除服务账户限制：更新服务账户 API 密钥 接受 character_limit: "clear"，可移除每月字符限制，此外还支持 "no_update" 和整数值。
• 告警 Webhook 引用：告警 Webhook 通知程序架构现在使用必填 webhook_id（字符串）标识工作区 Webhook，而非嵌入 url、method 和 headers。

SDK 发布

JavaScript SDK

• v2.59.0 - 新增 music.finetunes 方法，可列出、创建、获取、更新和删除 Music Finetunes。还新增了对话引用解析、已归档发音词典筛选和单次 Speech to Text 令牌。

Python SDK

• v2.59.0 - 根据最新 API 架构新增 Music Finetunes 和对话引用解析。OnPremInitiationData 还新增类型化的 post_call_transcription_webhook 和 post_call_audio_webhook 配置，并提供可选 hmac_secret，用于签名通话后 Webhook。

软件包

• @elevenlabs/client@1.15.1 - 改进了 Scribe Realtime 在设置失败、客户端或服务器关闭以及延迟音频帧期间的错误传递和麦克风清理。
• @elevenlabs/react@1.10.1、@elevenlabs/react-native@1.2.15、@elevenlabs/convai-widget-core@0.14.11 和 @elevenlabs/convai-widget-embed@0.14.11 - 更新依赖项，以包含 @elevenlabs/client@1.15.1 的 Scribe Realtime 修复。

Android SDK

• v0.11.1 - 防止 R8 和 ProGuard 混淆传出 WebSocket 和 WebRTC 事件字段，如 text 和 type。

CLI

• @elevenlabs/cli@0.5.6 - 更新默认智能体模板，使用 scribe_realtime 替代已移除的 elevenlabs ASR 提供商。精简模板仍使用服务器默认设置。

API