> 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.

### ElevenAgents

- **电话按键输入**：智能体对话配置现支持可选的 `dtmf_input_settings`，用于 [DTMF 输入](/docs/zh/eleven-agents/customization/multimodal-input#dtmf-input)。可配置数字输入超时、使用 `#` 作为结束符，并从转录文本、日志和分析中隐藏按键输入内容。
- **对话附件历史记录**：[获取对话](/docs/zh/api-reference/conversations/get)的转录条目现包含 `file_inputs`，这是一个数组，包含每个附件文件的 ID、名称、MIME 类型和 URL。
- **智能体标签筛选**：[列出智能体](/docs/zh/api-reference/agents/list)现接受可选的 `tags` 查询参数。重复该参数可匹配带有任一指定标签的智能体。
- **批量活动上下文**：[获取对话](/docs/zh/api-reference/conversations/get)现可通过可为 null 的 `campaign` 元数据识别批量呼叫，其中包含必需的 `campaign_id` 和 `campaign_lead_id`。

### 音乐

- **波形可视化数据**：[详细生成音乐](/docs/zh/api-reference/music/compose-detailed)、[流式生成音乐及详情](/docs/zh/api-reference/music/compose-detailed-stream)和[上传音乐](/docs/zh/api-reference/music/upload)现接受可选的 `with_waveform_visual`（布尔值，默认 `false`）。选择启用后，响应会返回低分辨率的 `waveform_visual` 整数数组，每秒包含 4 个采样点。

### 配音

- **项目分页行为**：[列出配音项目](/docs/zh/api-reference/dubbing/list-projects)和[列出语言目标](/docs/zh/api-reference/dubbing/language-targets/list-language-targets)现会将 `page_size` 限制在 1–100。项目状态筛选新增 `queued`，且两个端点均说明如何使用 `next_cursor` 获取下一页。

### SDK 发布

#### JavaScript SDK

- [v2.66.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.66.0) - 为 `sendMultimodalMessage` 添加 `fileIds`，一条消息现在可包含多个文件附件。

#### Python SDK

- [v2.66.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.66.0) - 为 `send_multimodal_message` 添加 `file_ids`，一条消息现在可包含多个文件附件。

#### Android SDK

- [v0.12.2](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.12.2) - 连接会话事件时保留 `onUnhandledClientToolCall` 回调。需要响应的未处理客户端工具调用现在会收到自动错误响应，而不再处于未解决状态。

#### ElevenLabs CLI

- [v1.1.0](https://github.com/elevenlabs/cli/releases/tag/v1.1.0) - 重新生成 API 命令绑定，并为 ElevenAgents workflow 添加命令级请求归因。这些命令会将 `cmd/<command>` 追加到 CLI 的 `User-Agent`，从而区分 `agents push` 和 `agents create` 等 workflow 发出的请求。

#### 软件包

- [@elevenlabs/client@1.23.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.23.0)、[@elevenlabs/react@1.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.15.0)、[@elevenlabs/types@0.22.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.22.1)、[@elevenlabs/react-native@1.2.25](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.25)、[@elevenlabs/convai-widget-core@0.17.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.17.1) 和 [@elevenlabs/convai-widget-embed@0.17.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.17.1) - 为 `sendMultimodalMessage` 添加 `fileIds`。客户端同时发送 `file` 和 `files` 字段以保持兼容性，React 则提供更新后的客户端 API。

### API

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

## 已更新端点

### ElevenAgents

- [列出智能体](/docs/zh/api-reference/agents/list) - `GET /v1/convai/agents`
  - 添加可选且可为 null 的 `tags`（字符串数组）。重复该查询参数可匹配任一指定标签。
- [创建智能体](/docs/zh/api-reference/agents/create)、[获取智能体](/docs/zh/api-reference/agents/get)和[更新智能体](/docs/zh/api-reference/agents/update)
  - 添加可选且可为 null 的 `conversation_config.conversation.dtmf_input_settings`（`DTMFInputConfig`）。支持 `dtmf_input_timeout`（数值，0.5–10 秒，默认 `2`）、`hash_terminator`（布尔值，默认 `true`）和 `redact_input`（布尔值，默认 `false`）。
  - 在电话号码转接配置中添加可选的 `sip_refer_play_dialtone`（布尔值，默认 `true`）。将其设为 `false`，可在 SIP REFER 转接完成期间保持原始通话线路静音。
  - 开始和结束流程系统工具现可接受 `ProcedureVersionRef` 或 `ProcedureDraftRef`。草稿引用需要 `procedure_id`（字符串），并将 `version_id` 设为 `null`。
- [获取对话](/docs/zh/api-reference/conversations/get) - `GET /v1/convai/conversations/{conversation_id}`
  - 在转录条目中添加 `file_inputs`（`ConversationHistoryTranscriptFileInputResponseModel` 数组）。每项都需要 `file_id`、`original_filename`、`mime_type` 和 `file_url`（字符串）。
  - 在批量呼叫元数据中添加可选且可为 null 的 `campaign`（`BatchCallingCampaignInformation`）。该对象需要 `campaign_id` 和 `campaign_lead_id`（字符串）。
  - 向 `ChatSourceMedium` 添加 `dtmf`。
- 对话分诊工单问题类型新增 `incorrect_information`、`documentation_gap`、`platform_bug` 和 `wrong_action`。

### 音乐

- [详细生成音乐](/docs/zh/api-reference/music/compose-detailed)（`POST /v1/music/detailed`）和[流式生成音乐及详情](/docs/zh/api-reference/music/compose-detailed-stream)（`POST /v1/music/detailed/stream`）
  - 添加可选的 `with_waveform_visual`（布尔值，默认 `false`）。
  - 详情响应新增可为 null 的 `waveform_visual`（整数数组），每秒采样 4 次，取值范围为 `-1000` 到 `1000`。
- [上传音乐](/docs/zh/api-reference/music/upload) - `POST /v1/music/upload`
  - 在响应中添加可选的 `with_waveform_visual`（布尔值，默认 `false`）和可为 null 的 `waveform_visual`（整数数组）。

### ElevenCreative

- [创建 Studio 项目](/docs/zh/api-reference/studio/add-project)和[创建播客](/docs/zh/api-reference/studio/create-podcast)
  - `quality_preset` 现接受 `null`，并移除了其 `standard` schema 默认值。

### 配音

- [列出配音项目](/docs/zh/api-reference/dubbing/list-projects) - `GET /v1/dubbing/project`
  - `page_size` 仍为可选整数，默认值为 `20`，但现在会将值限制在 1–100，而非拒绝请求。
  - `status` 筛选器现说明 `queued`、`preparing`、`ready` 和 `failed`。
  - 将上一响应的 `next_cursor` 传入 `cursor`；获取第一页时省略该参数。
- [列出语言目标](/docs/zh/api-reference/dubbing/language-targets/list-language-targets) - `GET /v1/dubbing/project/{project_id}/language`
  - `page_size` 仍为可选整数，默认值为 `20`，但现在会将值限制在 1–100，而非拒绝请求。
  - `status` 筛选器支持 `queued`、`processing`、`completed`、`stale` 和 `failed`。
  - 将上一响应的 `next_cursor` 传入 `cursor`；获取第一页时省略该参数。

## Schema 变更

### 工作区

- `PendingSubscriptionSwitchResponseModel.next_tier` 新增 `grant`。

</Accordion>