Changelog

July 28, 2025

工作区

  • 服务账户 API 密钥管理：新增用于管理服务账户 API 密钥的完整 API 端点，包括创建、获取、更新和删除功能。请参阅服务账户文档。

智能体平台

  • 通话后 webhook 迁移：正在迁移通话后 webhook 格式，以便在 SDK 中自动生成 webhook 处理程序。这不是破坏性变更；如果当前处理程序可接受额外字段，则无需进一步操作。详情请参阅此处。
  • 智能体转接改进：修复系统变量 system_agent_id，使其在智能体间转接后能正确更新，确保准确追踪对话上下文。新增 system_current_agent_id 变量，用于追踪当前活跃的智能体。详细了解动态变量。
  • 增强公共智能体页面：为公共的与智能体对话页面新增文本输入功能和动态变量支持。现在可通过 URL 参数传递动态变量（例如 ?var_username=value），并在语音对话期间使用文本输入。请参阅动态变量指南。
  • 语音信箱检测：为 ElevenLabs 智能体新增语音信箱检测内置工具，改进通话处理。了解语音信箱检测。
  • 对话筛选：为对话列表端点新增 user_id 查询参数，可按发起用户筛选对话。

语音转文本

  • 多声道转录：为转录端点新增 use_multi_channel 参数，用于处理不同声道中包含多位说话人的音频文件。最多支持 5 个声道，并提供按声道划分的转录结果。请参阅多声道指南。

ElevenCreative Studio

  • 字幕支持：为 ElevenCreative Studio 项目新增字幕功能，播客和通用项目均支持新的 captions_enabled 和 caption_style 属性。详细了解 ElevenCreative Studio。

SDK

API 架构更新

新端点

  • 服务账户管理：新增 5 个用于管理服务账户 API 密钥的端点：
    • GET /v1/service-accounts/{service_account_user_id}/api-keys - 获取服务账户 API 密钥
    • POST /v1/service-accounts/{service_account_user_id}/api-keys - 创建服务账户 API 密钥
    • DELETE /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id} - 删除服务账户 API 密钥
    • PATCH /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id} - 更新服务账户 API 密钥
    • GET /v1/service-accounts - 获取工作区服务账户

移除的端点

  • 旧版项目端点：作为 ElevenCreative Studio API 整合的一部分，移除 22 个已弃用的项目管理端点：
    • 所有 /v1/projects/* 端点（由 /v1/studio/projects/* 替代）
    • 旧版文本转语音端点（/v1/text-to-voice/create-voice-from-preview、/v1/text-to-voice/remixing-sessions/*）
    • 旧版 ConvAI 知识库端点

更新的端点

语音转文本

  • 多声道支持：更新 /v1/speech-to-text 端点：
    • 新增 use_multi_channel 参数，用于处理多说话人音频文件
    • 修改响应结构，包含可选的 language_code、language_probability、text 和 words 属性

智能体平台

  • 增强智能体配置：更新智能体创建和管理端点：
    • 在内置工具中新增语音信箱检测
    • 使用 max_retrieved_rag_chunks_count 参数改进 RAG 配置
    • 使用 source 和 version 参数增强对话令牌端点
    • 在对话列表端点中新增 user_id 筛选

ElevenCreative Studio 项目

  • 字幕支持：更新 ElevenCreative Studio 项目端点，新增：
    • captions_enabled 属性，用于启用或禁用字幕
    • caption_style 属性，用于全局字幕样式配置

文本转语音

  • 改进音色生成：增强音色创建端点，新增：
    • loudness 控制（范围为 -1 至 1，0 对应 -24 LUFS）
    • quality 参数，用于平衡输出质量和多样性
    • guidance_scale 参数，用于控制 AI 创造性与提示词遵循度