> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

### 音乐

- **流式获取含详细信息的音乐**：新增 [流式获取含详细信息的音乐](/docs/zh/api-reference/music/compose-detailed-stream)（`POST /v1/music/detailed/stream`），可通过 SSE 流式获取生成的音频及详细元数据，包括编曲计划、歌曲元数据、base64 音频分块，以及通过 `with_timestamps` 提供的可选词级时间戳。

### ElevenAgents

- **模拟对话弃用**：[模拟对话](/docs/zh/api-reference/agents/simulate-conversation)和[流式模拟对话](/docs/zh/api-reference/agents/simulate-conversation-stream)已弃用，建议改用[创建测试](/docs/zh/api-reference/tests/create)和[在智能体上运行测试](/docs/zh/api-reference/tests/run-tests)。
- **工具打断模式**：`disable_interruptions` 已在智能体工具和 MCP 服务器架构中弃用。请改用 `interruption_mode`（`ToolInterruptionMode`：`allow`、`disable_during_tool`、`disable_during_tool_and_turn`），并可通过工具覆盖模型中的 `interruption_mode` 为各工具单独设置。
- **数值评估评分**：评估条件架构新增可选 `scoring_mode`（`binary` ｜ `numeric_uniform`）、可选 `max_score`（整数）和可选 `score_instructions`（字符串）。评估结果新增可选数值 `score`。对话分析负载新增可选 `call_success_score` 和 `success_score`。
- **对话推理**：转录和历史记录模型新增可选 `reasoning`（`ConversationReasoningModel`），转录响应新增可选 `reasoned`（布尔值）。智能体提示词和 LLM 架构新增可选 `enable_reasoning_summary`（布尔值）。
- **对话平台计费**：对话相关模型新增可选 `platform_charge`、`platform_price` 和 `platform_usage`，并通过 `PlatformCategory` 和 `PlatformCategoryUsage` 提供按类别细分的数据。
- **对话费用元数据**：对话历史记录元数据新增必填只读 `cost_fiat`（数值，美元）。
- **未脱敏 Webhook 事件**：`WebhookEventType` 新增 `unredacted_transcript` 和 `unredacted_audio`，供需要未脱敏负载的 Webhook 订阅使用。
- **工作流电话转接 UUI 限制**：用于 SIP REFER 转接 RFC 7433 用户间信息的 `UUITransferConfig.data` 最大长度从 256 个字符增至 8192 个字符。

### 语音引擎

- **可选跳过身份验证**：JavaScript 和 Python SDK v2.56.0 为语音引擎 WebSocket 客户端新增可选 `disableAuth` / `disable_auth`。适用于通过其他方式保护连接的集成，例如 IP 允许列表或自定义身份验证请求头，而非 API 密钥身份验证。

### 工作区

- **专业语音席位跟踪**：订阅式模型新增可选 `professional_voice_slots_used_in_workspace`，并明确了适用于群组整体的 `professional_voice_slots_used`，以便集中查看计费情况。

### ElevenCreative Studio

- **字幕样式**：字幕样式模型新增模糊和圆角字段。进入和退出动画枚举新增 `slam`、`scale_down` 和 `slide_in`。

### SDK 发布

#### JavaScript SDK

- [v2.56.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.56.0) - 为语音引擎 WebSocket 客户端新增可选 `disableAuth`。根据最新 OpenAPI 架构重新生成，包含音乐详细流式传输、工具 `interruption_mode`、评估评分模式、对话推理和平台计费字段。

#### Python SDK

- [v2.56.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.56.0) - 为语音引擎 WebSocket 客户端新增可选 `disable_auth`。根据最新 OpenAPI 架构重新生成，包含音乐详细流式传输、工具 `interruption_mode`、评估评分模式、对话推理和平台计费字段。

#### CLI

- [@elevenlabs/cli@0.5.5](https://github.com/elevenlabs/cli/releases/tag/@elevenlabs%2Fcli%400.5.5) - 智能体创建和更新请求现以原始 JSON 发送，以保持配置往返一致性。

### API

<Accordion title="查看 API 变更">

## 新增端点

### 音乐

- [流式获取含详细信息的音乐](/docs/zh/api-reference/music/compose-detailed-stream) - `POST /v1/music/detailed/stream`

## 更新的端点

### ElevenAgents

- [模拟对话](/docs/zh/api-reference/agents/simulate-conversation) - `POST /v1/convai/agents/{agent_id}/simulate-conversation`
  - 已标记为弃用；请改用[创建测试](/docs/zh/api-reference/tests/create)和[在智能体上运行测试](/docs/zh/api-reference/tests/run-tests)
- [流式模拟对话](/docs/zh/api-reference/agents/simulate-conversation-stream) - `POST /v1/convai/agents/{agent_id}/simulate-conversation/stream`
  - 已标记为弃用；请改用[创建测试](/docs/zh/api-reference/tests/create)和[在智能体上运行测试](/docs/zh/api-reference/tests/run-tests)

## 架构变更

### ElevenAgents

- 工具和 MCP
  - 已弃用 `disable_interruptions`，改用 `interruption_mode`（`allow`、`disable_during_tool`、`disable_during_tool_and_turn`）
  - MCP 和工具覆盖模型新增按工具设置的 `interruption_mode` 覆盖项
- 评估和分析
  - 评估条件新增可选 `scoring_mode`、`max_score` 和 `score_instructions`
  - 评估结果新增可选数值 `score`
  - 对话分析负载新增可选 `call_success_score` 和 `success_score`
- 转录和推理
  - 转录和历史记录模型新增可选 `reasoning`（`ConversationReasoningModel`）
  - 转录响应新增可选 `reasoned`（布尔值）
  - 智能体提示词和 LLM 架构新增可选 `enable_reasoning_summary`（布尔值）
- 计费和元数据
  - 对话模型新增可选 `platform_charge`、`platform_price` 和 `platform_usage`
  - 对话历史记录元数据新增必填只读 `cost_fiat`（美元）
- Webhook
  - `WebhookEventType` 新增 `unredacted_transcript` 和 `unredacted_audio`
- 工作流
  - `UUITransferConfig.data` 最大长度从 256 个字符增至 8192 个字符

### 工作区

- 计费
  - 订阅式模型新增可选 `professional_voice_slots_used_in_workspace`

### ElevenCreative Studio

- 字幕
  - 字幕样式模型新增模糊和圆角字段
  - 新增 `slam`、`scale_down` 和 `slide_in` 动画类型

</Accordion>