Changelog

开发者资源

• ElevenLabs Devs YouTube 频道：全新面向开发者的 YouTube 频道 现已上线，提供教程、API 演示和技术深度解析，帮助你充分使用 ElevenLabs 平台。

ElevenAgents

• 工作流起始节点覆盖：现在可在对话发起客户端数据中传入 starting_workflow_node_id，从指定工作流节点开始对话。此功能由智能体平台覆盖设置中的选择启用字段 enable_starting_workflow_node_id_from_client 控制。启用后，客户端可指定从哪个节点开始对话，适用于智能体记忆和长期 WebSocket 使用场景。如果指定节点不存在，对话会回退到默认入口点。

• 通话后分析 LLM 配置：智能体平台设置现包含 analysis_llm 字段（默认值：gemini-2.5-flash），用于设置通话后分析的默认 LLM，包括评估标准和数据收集。各数据收集属性可通过新的 AnalysisProperty 架构中的单项 llm 字段覆盖此默认值，从而精细控制处理每个分析项所用的模型。

• 新增 LLM 选项：智能体配置可用的 LLM 提供商列表新增 gpt-5.4。LLMReasoningEffort 枚举新增 xhigh，支持在兼容模型上进行扩展推理。

• 工作流表达式中的 null 字面量：工作流条件表达式现通过新增 ASTNullNode 类型支持 null 比较，可在工作流逻辑中创建“如果变量为 null”之类的分支。

• 按 ID 获取密钥：新增 获取密钥 端点（GET /v1/convai/secrets/{secret_id}），可按 ID 获取单个工作区密钥。列出密钥 端点现也支持 search 查询参数，可按名称前缀筛选密钥。

• 批量呼叫中的可搜索电话号码：控制台的批量呼叫表单现包含可搜索的电话号码选择器，配置批量呼叫时更易找到合适的外呼号码。

语音转文本

• 说话人角色检测：语音转文本 端点现支持 detect_speaker_roles 参数（布尔值，默认 false）。与 diarize=true 一同启用时，返回的说话人标签将为 agent 和 customer，而非 speaker_0、speaker_1。此功能不可与 use_multi_channel=true 一起使用。使用时将在基础转录费用上额外收取 10% 附加费。

文本转对话

• 输入字符数限制说明：文本转对话 端点现说明，建议每次请求中所有 inputs[].text 值总计不超过 2,000 个字符。更长的请求可能会导致流式响应提前终止，或返回验证错误。

工作区

• 用量分析端点：新增 按产品查看一段时间内的用量 端点（POST /v1/workspace/analytics/query/usage-by-product-over-time），可返回按产品类型和时间细分的额度用量。结果以表格结构返回，支持配置 interval_seconds、group_by 维度和 filters。此前的 GET /v1/usage/character-stats 端点已弃用，建议改用此新端点。

SDK 发布

软件包

• @elevenlabs/client@1.2.1 - 修复对话启动就绪状态，确保会话标记为已连接且 React 已同步 conversationRef 后才运行 onConnect。同时公开并转发 onConversationCreated，供需要在 onConnect 前获取已创建 Conversation 实例的使用者调用。

• @elevenlabs/react@1.1.1 - 修复对话启动就绪状态，并公开 onConversationCreated 回调，与 @elevenlabs/client@1.2.1 的变更保持一致。

• @elevenlabs/react-native@1.1.1、@elevenlabs/convai-widget-core@0.11.4、@elevenlabs/convai-widget-embed@0.11.4 - 更新至 @elevenlabs/client@1.2.1，包含对话启动修复。

API