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

### ElevenCreative

- **图像、视频和语音生成 API**：新的异步 Flows API 可创建、列出和获取视频、图像及语音生成任务。生成响应提供 `pending`、`generating`、`completed` 和 `failed` 状态，请求还可包含用于接收完成事件的 Webhook 目标。
- **可复用媒体资源**：新的资源 API 可上传、列出、获取和删除工作区媒体。图像、视频和音频引用可使用已上传资源、之前的生成结果或内联 base64 数据，从而串联生成任务。参阅[引用和资源](/docs/zh/eleven-api/guides/how-to/image-and-video/references)。

### ElevenAgents

- **轻量级对话摘要**：[获取对话摘要](/docs/zh/api-reference/conversations/get-summary)返回生成的标题、转录摘要、通话结果，以及无需加载完整转录的纯用户或智能体消息。可选的 `max_messages` 查询参数为介于 1 到 200 之间的整数（默认 `40`）；较长的对话会将 `messages_omitted` 设为 `true`。适用于需要保留上下文的智能体。
- **对话主题分页和排序**：[获取智能体对话主题](/docs/zh/api-reference/conversations/topics/get)新增可选的游标分页和排序。使用 `page_size`（整数，1–100）、`cursor`（字符串）、`sort_by`（`conversations`、`sentiment` 或 `success_rate`）和 `sort_direction`（`asc` 或 `desc`）。响应新增 `has_more` 和可为空的 `next_cursor`。
- **并发等待队列**：智能体平台设置新增可选的 `queueing`（`AgentQueueingConfig`）。当智能体达到并发限制时，将 `enabled` 设为 `true` 可让来电者等待；`wait_timeout_seconds` 为最高 1,800 的整数（默认 `180`）。
- **轮次和工作流控制**：轮次配置新增 `merge_with_default_ignore_terms`（布尔值，默认 `false`），用于将自定义中断词与精选默认词合并。软超时新增 `disable_until_first_user_message`（布尔值，默认 `false`），工作流工具定位器新增可选的 `schema_overrides`，用于按节点覆盖参数。
- **背景音频默认值**：`BackgroundSoundConfig.volume` 默认值现从 `0.6` 改为 `0.15`，`crossfade_loop` 默认值现从 `false` 改为 `true`。请显式设置这些字段以保留原有行为。

### SDK 发布

#### JavaScript SDK

- [v2.64.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.64.0) - 新增 `client.assets`，可上传、列出、获取和删除资源；新增 `client.flows`，用于异步生成视频、图像和语音。轮次配置新增 `mergeWithDefaultIgnoreTerms`。从 `WorkspaceGroupResponseModel` 中移除 `CustomToolApiSchemaConfig` 和 `scimExternalId`。

#### Python SDK

- [v2.64.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.64.0) - 新增资源和 Flows 客户端，用于异步生成视频、图像和语音；轮次配置新增 `merge_with_default_ignore_terms`。本地部署会话设置新增 `extra_setup_config`，用于传递其他设置消息字段。

#### 软件包

- [@elevenlabs/client@1.18.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.18.0), [@elevenlabs/react@1.12.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.1), [@elevenlabs/types@0.20.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.20.0), [@elevenlabs/react-native@1.2.19](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.19), [@elevenlabs/convai-widget-core@0.16.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.0) 和 [@elevenlabs/convai-widget-embed@0.16.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.0) - 新增实验性的自托管编排器会话和富内容事件。Scribe 音频 worklet 现可自托管，以满足严格的内容安全策略。断开连接处理现在会稳定进入 `disconnected` 状态，并防止延迟回调清除较新的会话。组件可内联呈现快捷回复和链接，恢复语音转录中的 Markdown，并修复容器查询布局中的语言菜单定位。
- [@elevenlabs/client@1.19.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.19.0), [@elevenlabs/react@1.12.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.2), [@elevenlabs/types@0.21.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.21.0), [@elevenlabs/react-native@1.2.20](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.20) 和 [@elevenlabs/convai-widget-core@0.16.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.1) - 新增实时语音转文本选项，支持次要语言、实体检测和背景音频过滤。新增最终转录、检测到的实体和无效请求事件；使时间戳单词类型与实时架构保持一致；并修复阻止 `useScribe` 重新连接的麦克风权限失败问题。

### API

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

## 新增端点

### ElevenCreative

- [创建视频生成任务](/docs/zh/api-reference/flows/video/create) - `POST /v1/flows/video`
- [列出视频生成任务](/docs/zh/api-reference/flows/video/list) - `GET /v1/flows/video`
- [获取视频生成任务](/docs/zh/api-reference/flows/video/get) - `GET /v1/flows/video/{generation_id}`
- [创建图像生成任务](/docs/zh/api-reference/flows/image/create) - `POST /v1/flows/image`
- [列出图像生成任务](/docs/zh/api-reference/flows/image/list) - `GET /v1/flows/image`
- [获取图像生成任务](/docs/zh/api-reference/flows/image/get) - `GET /v1/flows/image/{generation_id}`
- [创建语音生成任务](/docs/zh/api-reference/flows/text-to-speech/create) - `POST /v1/flows/text-to-speech`
- [列出语音生成任务](/docs/zh/api-reference/flows/text-to-speech/list) - `GET /v1/flows/text-to-speech`
- [获取语音生成任务](/docs/zh/api-reference/flows/text-to-speech/get) - `GET /v1/flows/text-to-speech/{generation_id}`
- [上传资源](/docs/zh/api-reference/assets/create) - `POST /v1/assets`
- [列出资源](/docs/zh/api-reference/assets/list) - `GET /v1/assets`
- [获取资源](/docs/zh/api-reference/assets/get) - `GET /v1/assets/{asset_id}`
- [删除资源](/docs/zh/api-reference/assets/delete) - `DELETE /v1/assets/{asset_id}`

### ElevenAgents

- [获取对话摘要](/docs/zh/api-reference/conversations/get-summary) - `GET /v1/convai/conversations/{conversation_id}/summary`
  - 接受可选的 `max_messages`（整数，1–200，默认 `40`）
  - 返回 `GetConversationSummaryResponseModel`，其中必填 `conversation_id`、`agent_id`、`status`、`message_count` 和 `note`
  - 纯 `messages` 仅包含 `role`（`user` 或 `agent`）和 `message`；超过限制的对话返回 `messages_omitted: true`

## 已更新端点

### ElevenAgents

- [获取实时数量](/docs/zh/api-reference/analytics/get) - `GET /v1/convai/analytics/live-count`
  - 新增可选的 `agent_ids`（字符串数组，最多 25 个），其优先级高于 `agent_id`
- [获取智能体对话主题](/docs/zh/api-reference/conversations/topics/get) - `GET /v1/convai/agents/{agent_id}/topics`
  - 新增可选的 `page_size`（整数，1–100）、`cursor`（字符串）、`sort_by`（`conversations`、`sentiment` 或 `success_rate`）和 `sort_direction`（`asc` 或 `desc`）
  - 响应新增 `has_more`（布尔值，默认 `false`）和可为空的 `next_cursor`（字符串）

## 架构变更

### ElevenAgents

- 智能体平台设置新增可选的 `queueing`（`AgentQueueingConfig`）。它包含 `enabled`（布尔值，默认 `false`）和 `wait_timeout_seconds`（大于 0 且最多 1,800 的整数，默认 `180`）
- `WorkflowToolLocator` 新增可选的 `schema_overrides`；按节点的常量、动态变量、LLM 或省略覆盖优先于工具级覆盖
- 轮次配置及相关覆盖架构新增 `merge_with_default_ignore_terms`（布尔值，默认 `false`）
- 软超时配置及相关覆盖架构新增 `disable_until_first_user_message`（布尔值，默认 `false`）
- 实时智能体工具响应事件新增必填只读 `status`（`success`、`error`、`blocked` 或 `skipped`）
- 对话发起来源新增 `avaya`，授权方式新增 `avaya_api_key`
- 支持的智能体 LLM 值新增 `gemini-3.6-flash` 和 `gemini-3.7-flash`
- `BackgroundSoundConfig.volume` 默认值从 `0.6` 改为 `0.15`，`crossfade_loop` 默认值从 `false` 改为 `true`
- 移除 `CustomToolApiSchemaConfig`；导入此类型的生成 SDK 用户必须移除该导入
- 从 `WorkspaceGroupResponseModel` 中移除 `scim_external_id`

</Accordion>