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

import { YoutubeEmbed } from "../../../components/YoutubeEmbed";

### Eleven v4 和 Eleven v4 Turbo

[Eleven v4 和 Eleven v4 Turbo](/docs/zh/overview/capabilities/text-to-speech/eleven-v4) 现已推出。Eleven v4 可在超过 90 种语言中提供更高质量、更具表现力的语音，以及更出色的语音克隆。Eleven v4 Turbo 属于同一模型系列，适用于实时应用，中位推理延迟约为 100 ms。

内容创作和长音频可通过文本转对话 API 使用 `eleven_v4`。智能体和交互式应用可通过文本转对话 WebSocket 使用 `eleven_v4_turbo`。

<YoutubeEmbed id="4QHFkK2MTcw" />

<CardGroup cols={3}>
  <Card
    title="Eleven v4 概览"
    icon="duotone book"
    href="/docs/zh/overview/capabilities/text-to-speech/eleven-v4"
  >
    对比两个模型版本、语音克隆行为、设置和支持的语言。
  </Card>
  <Card
    title="文本转对话 API"
    icon="duotone code"
    href="/docs/zh/api-reference/text-to-dialogue/convert"
  >
    使用 Eleven v4 生成高质量对话。
  </Card>
  <Card
    title="实时流式传输"
    icon="duotone code"
    href="/docs/zh/eleven-api/guides/how-to/websockets/realtime-tdd"
  >
    通过 WebSocket 连接流式传输 Eleven v4 Turbo 对话。
  </Card>
</CardGroup>

### 语音转文字

- **转录编辑**：批量和实时转录现可接受最长 2,000 个字符的自然语言编辑指令。批量响应会在 `edited_transcript` 中返回结果，实时会话则会发出 `edited_transcript` 事件。有关不兼容项、响应处理和定价，请参阅[批量](/docs/zh/eleven-api/guides/how-to/speech-to-text/batch/transcript-editing)和[实时](/docs/zh/eleven-api/guides/how-to/speech-to-text/realtime/transcript-editing)指南。

### ElevenAgents

- **智能体模型**：在支持的智能体 LLM 选项中新增 `gpt-6-sol`、`gpt-6-luna`、`glm-52`、`deepseek-v41-flash`、`claude-opus-5` 和 `claude-opus-5-5`。
- **智能体测试用量**：测试调用摘要可包含总积分和美元价格。单次测试运行可包含积分和计费明细。

### Flows

- **模板 API**：新增用于列出和获取已发布 Flows 模板、启动模板运行及获取运行结果的端点。运行可指定已发布版本，并将最终结果发送至配置的 webhook。

### 文本转对话

- **生成连续性**：文本转对话请求可使用前文或后文以及请求 ID，以保持多次生成之间的连续性。
- **专业音色模式**：文本转对话请求可使用专业语音克隆的即时语音克隆版本，以降低延迟或提升表现力。

### SDK 发布

#### JavaScript SDK

- [v2.70.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.70.0) - 新增批量和实时语音转文字转录编辑类型、测试调用摘要的 `branchId` 筛选和费用字段、知识库自动发现、文本转对话 `usePvcAsIvc` 以及 `deepseek-v41-flash` 智能体模型。

#### Python SDK

- [v2.70.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.70.0) - 新增批量和实时语音转文字转录编辑类型、测试调用摘要的 `branch_id` 筛选和费用字段、知识库自动发现、文本转对话 `use_pvc_as_ivc` 以及 `deepseek-v41-flash` 智能体模型。

#### ElevenLabs CLI

- [v1.4.0](https://github.com/elevenlabs/cli/releases/tag/v1.4.0) - 修复使用明确 API 密钥的请求同时发送已存储 OAuth 凭据的问题，该问题会导致身份验证失败。为反馈命令组添加说明，并为生成的智能体技能添加报告缺失功能的说明。使用 Flows 模板端点和当前架构类型重新生成 API 客户端。

### API

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

## 新增端点

### Flows

- [列出模板](/docs/zh/api-reference/flows/templates/list) - `GET /v1/flows/templates` - 列出已发布模板及其可运行版本。
- [获取模板](/docs/zh/api-reference/flows/templates/get) - `GET /v1/flows/templates/{template_id}` - 获取模板及其可运行版本。
- [创建模板运行](/docs/zh/api-reference/flows/templates/runs/create) - `POST /v1/flows/templates/{template_id}/runs` - 使用输入值、可选版本和可选 webhook 启动模板运行。
- [列出模板运行](/docs/zh/api-reference/flows/templates/runs/list) - `GET /v1/flows/templates/{template_id}/runs` - 使用游标分页和可选版本筛选列出模板运行。
- [获取模板运行](/docs/zh/api-reference/flows/templates/runs/get) - `GET /v1/flows/templates/{template_id}/runs/{run_id}` - 获取模板运行及其输出状态。

## 更新的端点

### 语音转文字

- [将语音转换为文字](/docs/zh/api-reference/speech-to-text/convert) - `POST /v1/speech-to-text`
  - 新增可选可空 `transcript_edit`（字符串），可接受最长 2,000 个字符的自然语言编辑指令。
  - 响应新增可选可空 `edited_transcript`。编辑成功时包含必填 `kind: "transcript"` 和 `text` 字段。编辑失败时包含必填 `kind: "error"`、`error_type: "edit_failed"` 和 `message` 字段。
- [实时语音转文字](/docs/zh/api-reference/speech-to-text/v-1-speech-to-text-realtime)接受 `transcript_edit`（字符串），并发出包含必填 `text` 和 `edited_text` 字段的 `edited_transcript` 事件。

### ElevenAgents

- [创建智能体](/docs/zh/api-reference/agents/create)、[获取智能体](/docs/zh/api-reference/agents/get)和[更新智能体](/docs/zh/api-reference/agents/update)
  - 在 `LLM` 枚举中新增 `gpt-6-sol`、`gpt-6-luna`、`glm-52`、`deepseek-v41-flash`、`claude-opus-5` 和 `claude-opus-5-5`。
  - 告警监控项新增可选可空 `enabled`（布尔值），用于控制监控项是否可发送通知。
- [列出对话](/docs/zh/api-reference/conversations/list)和[文本搜索](/docs/zh/api-reference/conversations/messages/text-search)
  - `data_collection_params` 和 `dynamic_variable_params` 新增 `neq` 和 `in` 运算符。`in` 的值使用竖线分隔。
  - `evaluation_params` 接受 `success`、`failure` 或 `unknown` 作为结果值。
- [智能搜索](/docs/zh/api-reference/conversations/messages/search) - `GET /v1/convai/conversations/messages/smart-search`
  - 新增可选可空 `branch_id`（字符串）。
- [列出测试调用](/docs/zh/api-reference/tests/test-invocations/list) - `GET /v1/convai/test-invocations`
  - 新增可选可空 `branch_id`（字符串）。
  - 测试调用摘要新增可选可空 `credits_used`（整数）和 `total_price`（数字）。
- [获取测试调用](/docs/zh/api-reference/tests/test-invocations/get) - `GET /v1/convai/test-invocations/{test_invocation_id}`
  - 单次测试运行新增可选可空 `credits_used`（整数）和 `charging`（`ConversationChargingCommonModel`）。
- [模拟对话](/docs/zh/api-reference/agents/simulate-conversation)和[模拟对话流](/docs/zh/api-reference/agents/simulate-conversation-stream)
  - 将可选 `new_turns_limit` 的默认值从 `10,000` 改为 `100`，并将最大值设为 `100`。
- [创建爬取任务](/docs/zh/api-reference/knowledge-base/create-crawl-job)和[获取爬取任务](/docs/zh/api-reference/knowledge-base/get-crawl-job)
  - 新增可选 `auto_discover`（布尔值，默认 `false`），用于在自动同步期间跟踪链接并添加新发现的页面。这需要 `enable_auto_sync: true`。
- [刷新知识库文档](/docs/zh/api-reference/knowledge-base/refresh) - `POST /v1/convai/knowledge-base/{documentation_id}/refresh`
  - `AutoSyncInfo` 新增可选 `auto_discover`（布尔值，默认 `false`），用于指示刷新时是否爬取并添加新发现的页面。
- [列出 MCP 服务器工具](/docs/zh/api-reference/mcp/list-tools) - `GET /v1/convai/mcp-servers/{mcp_server_id}/tools`
  - 响应新增可选 `tool_approval_statuses`（数组）。每项包含必填 `tool_id`（字符串）和 `state`（`up_to_date`、`needs_review` 或 `not_approved`），以及可选的审批策略和已批准定义字段。

### 文本转对话

- [将文本转换为对话](/docs/zh/api-reference/text-to-dialogue/convert)、[流式转换文本为对话](/docs/zh/api-reference/text-to-dialogue/stream)、[转换并附带时间戳](/docs/zh/api-reference/text-to-dialogue/convert-with-timestamps)和[流式转换并附带时间戳](/docs/zh/api-reference/text-to-dialogue/stream-with-timestamps)
  - 新增可选 `use_pvc_as_ivc`（布尔值，默认 `false`），用于使用专业语音克隆的即时语音克隆版本。
  - 新增可选可空 `previous_text` 和 `future_text`（字符串，最长 100 个字符），以及 `previous_request_ids` 和 `next_request_ids`（字符串数组，最多 3 个 ID），用于保持生成连续性。
  - 可选 `settings` 对象新增可空 `similarity`（数字，0–1，默认 `0.75`）。

### 文本转语音

- [将文本转换为语音](/docs/zh/api-reference/text-to-speech/convert)、[流式转换文本为语音](/docs/zh/api-reference/text-to-speech/stream)、[转换并附带时间戳](/docs/zh/api-reference/text-to-speech/convert-with-timestamps)和[流式转换并附带时间戳](/docs/zh/api-reference/text-to-speech/stream-with-timestamps)
  - 现有的 `use_pvc_as_ivc` 字段不再弃用。

### Flows

- [创建图像生成](/docs/zh/api-reference/flows/image/create)、[创建视频生成](/docs/zh/api-reference/flows/video/create)和[创建模板运行](/docs/zh/api-reference/flows/templates/runs/create)
  - Webhook 目标现在需要明确的 `type` 区分符（`all` 或 `ids`）。已移除之前的默认值。

### 声音设计

- [从预览创建声音](/docs/zh/api-reference/text-to-voice/create)、[创建声音预览](/docs/zh/api-reference/legacy/voices/create-previews)、[设计声音](/docs/zh/api-reference/text-to-voice/design)和[混音声音](/docs/zh/api-reference/text-to-voice/remix)
  - 当预览的生成已在进行时，新增 `409` 响应。收到此响应后请重试请求。

### 工作区

- [创建服务账户 API 密钥](/docs/zh/api-reference/service-accounts/api-keys/create) - `POST /v1/service-accounts/{service_account_user_id}/api-keys`
  - 为企业版服务账户 API 密钥新增可选可空 `tts_concurrency_limit`、`music_concurrency_limit` 和 `dubbing_concurrency_limit`（整数）。
- [更新服务账户 API 密钥](/docs/zh/api-reference/service-accounts/api-keys/update) - `PATCH /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id}`
  - 新增可选 `tts_concurrency_limit`、`music_concurrency_limit` 和 `dubbing_concurrency_limit`。每个字段可接受整数、`clear`、`no_update` 或 `null`，默认值为 `no_update`。

### 模型

- [列出模型](/docs/zh/api-reference/models/list) - `GET /v1/models`
  - 弃用必填 `max_characters_request_free_user` 和 `max_characters_request_subscribed_user`。这些字段不会强制执行；请改用 `maximum_text_length_per_request`。

</Accordion>