> 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. # 更新日志 ## October 19, 2026 import { YoutubeEmbed } from "../../../components/YoutubeEmbed"; ### Eleven Realtime Eleven Realtime is a new family of models for ElevenAgents voice agents, rolling out gradually across workspaces. Each one is a complete voice agent configuration. You pick one model, and ElevenLabs handles the LLM, Speech to Text and Text to Speech settings behind it. Your agent's system prompt, voice, tools and knowledge base work the same as before. There are two to choose from. Eleven Realtime v1 Mini (`eleven_realtime_v1_mini`) is the default, and it's the fastest and cheapest. Eleven Realtime v1 Max (`eleven_realtime_v1_max`) reasons before it answers, so use it when your agent has complex instructions or multi-step tool calls. If you've already built on OpenAI's Realtime API, you don't need to rewrite your client. The events and the WebSocket transport are the same, so you change the endpoint and the session configuration. Your backend calls [Create realtime client secret](/docs/api-reference/conversations/create-client-secret) to get a short-lived secret, and the browser uses it to connect directly. Choose a Realtime model and configure an agent's voice mode. Connect an existing OpenAI Realtime client to ElevenLabs. Review the request and response for minting client secrets. ### Realtime Translation Realtime Translation turns speech in one language into speech in another while the speaker is still talking. It's a [WebSocket API](/docs/api-reference/realtime-translation/v-1-translation-realtime), available now for enterprise workspaces. You open a connection with a `target_language` and a `voice_id`, then stream audio in. You get translated speech back in that voice. You don't have to say which language the speaker is using, because it's detected automatically, but you can set `source_language` if you know it. Along the way, the server also sends live transcripts of the original speech and the translated text, for example to show captions. `eagerness` controls the tradeoff between speed and quality. `high` starts translating soonest, and `low` waits for more of the sentence. The translated voice uses Eleven v4 Turbo by default, and you can switch to `eleven_v3` or `eleven_flash_v2_5` with `tts_model_id`. For sensitive conversations, set `enable_zrm=true` to use [Zero Retention Mode](/docs/eleven-api/resources/zero-retention-mode). Review the connection parameters and message types. Compare the TTS models available for translated speech. Keep transcripts and translations out of logs and history. ### Video to Music Video to Music writes a soundtrack for your video. The [Video to music](/docs/api-reference/music/video-to-music) API is now available: you upload a video and get back music that fits it, without writing a music prompt from scratch. Use it to score product videos, ads and social clips. You can send up to 10 video files (200 MB combined). They're joined in order and scored as one video. To steer the result, add a text `description` and up to 10 style `tags`. Three options are worth knowing. `use_audio_as_reference` takes the genre, BPM, instruments and mood from the video's own audio. `add_sfx` adds sound effects that match the video. `separate_tracks` returns the music and the sound effects as separate files in a ZIP, so you can mix them yourself. Review the request parameters and response format. Learn what Eleven Music can generate and how it can be used. ### ElevenAgents - **Alerts**: [Alerts](/docs/eleven-agents/operate/alerts) notify a workspace when agent error rates exceed a threshold or rise sharply above their recent baseline. Monitors cover conversation failures, tool failures, webhook errors, guardrail triggers, call initiation errors and evaluation success scores, and run with default thresholds without any setup. Agent-level thresholds and notifiers can be set through `platform_settings.alerting` on [Update agent](/docs/api-reference/agents/update). Notifications can be delivered as webhooks, to Slack or to PagerDuty. - **Guardrails generally available**: [Guardrails](/docs/eleven-agents/best-practices/guardrails) are no longer in alpha. - **Workspace environments**: Environments for [environment variables](/docs/eleven-agents/integrate/environment-variables) can now be managed through the API with [List environments](/docs/api-reference/environments/list), [Create environment](/docs/api-reference/environments/create) and [Delete environment](/docs/api-reference/environments/delete). A variable without a value for an environment falls back to its `production` value. Deleting an environment removes its values from all variables, and `production` cannot be deleted. - **Answering machine detection actions**: Twilio answering machine detection settings on [Outbound call](/docs/api-reference/twilio/outbound-call) and [Submit batch call](/docs/api-reference/batch-calling/create) accept `actions`, a list of rules that pair an `action` (`hang_up`) with the `answered_by` verdicts that trigger it, such as `machine_start` or `fax`. Verdicts without a rule leave the call running. - **New LLMs**: Agents can use `gemini-4-argon`, `claude-opus-4-6` and the ElevenLabs-hosted `nemotron-35-super-vl-nvfp4`. See [Models](/docs/eleven-agents/customization/llm). - **Authored-only workflow reads**: [Get agent](/docs/api-reference/agents/get) and [Update agent](/docs/api-reference/agents/update) accept `include_procedure_generated_workflow_elements`. Set it to `false` to receive only the workflow nodes and edges you authored, excluding the ones compiled from [structured procedures](/docs/eleven-agents/customization/procedures/structured-procedures). Defaults to `true`, so existing callers are unchanged. - **Branch rebasing from any branch**: [Rebase branch](/docs/api-reference/agents/branches/rebase) and [Preview rebase](/docs/api-reference/agents/branches/preview-rebase) accept an optional `source_branch_id` to pull changes from a branch other than main. - **Delete agents used as subagents**: [Delete agent](/docs/api-reference/agents/delete) accepts `force`. When `true`, the agent is deleted even if other agents use it as a subagent, and it is removed from those agents and their branches. - **Sort agents by last update**: [List agents](/docs/api-reference/agents/list) accepts `sort_by=updated_at`, and each agent summary includes `updated_at_unix_secs`, the last time the main branch or agent-level settings changed. - **Google Calendar event updates**: The [Google Calendar integration](/docs/eleven-agents/customization/integrations/google_calendar) adds `google_calendar_update_event` and `google_calendar_delete_event` tools. Both are privileged tools that can change or cancel any event on the connected calendar. ### Music and Sound Effects - **Zero Retention Mode**: Music generation, composition plan, stem separation and video to music endpoints, plus [Sound Effects](/docs/api-reference/text-to-sound-effects/convert), accept `enable_logging=false` to use [Zero Retention Mode](/docs/eleven-api/resources/zero-retention-mode). Zero Retention Mode is available to enterprise customers. Music requests that set `store_for_inpainting=true` are rejected in this mode. - **WAV output for sound effects**: [Sound Effects](/docs/api-reference/text-to-sound-effects/convert) accepts `wav_8000`, `wav_16000`, `wav_22050`, `wav_24000`, `wav_32000`, `wav_44100` and `wav_48000` output formats. ### Speech Engine - **40-minute conversations**: [Speech Engine](/docs/overview/capabilities/speech-engine) supports conversations of up to 40 minutes. The default limit remains 10 minutes. Raise `conversation.max_duration_seconds` to allow longer conversations. - **Sort by last update**: [List Speech Engines](/docs/api-reference/speech-engine/list) accepts `sort_by=updated_at`, and each summary includes `updated_at_unix_secs`. ### Dubbing - **Subtitles for dubbed languages**: Dubbing project language outputs (`GET /v1/dubbing/project/{project_id}/language/{language_id}`) include `subtitles`, a signed URL to the translated lines as WebVTT subtitles timed to the source speech. The URL expires one hour after it is issued. ### Voices - **Resubmittable voice reviews**: Voice sharing `review_status` adds `declined_resubmittable` for declined voices that can be resubmitted for review. ### Workspaces - **Disable service account API keys**: [Disable service account API key](/docs/api-reference/service-accounts/api-keys/disable) disables a service account API key without changing its other settings. It remains available after a workspace downgrades from a plan that includes service accounts. - **Group concurrency limits**: [List workspace groups](/docs/api-reference/workspace/groups/list) and [List service accounts](/docs/api-reference/service-accounts/list) return `group_concurrency_limit`, `group_dubbing_concurrency_limit` and `group_music_concurrency_limit` for each group, and group permissions add `all_resources_access`. ### SDK releases #### JavaScript SDK - [v2.74.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.74.0) - Added `client.conversationalAi.realtime.createClientSecret` for the Realtime API, with the `RealtimeModel` and OpenAI-compatible session configuration types, and an `environments` client with `list`, `create` and `delete`. Also adds `force` on agent deletion, `sourceBranchId` on branch rebase and rebase preview, `includeProcedureGeneratedWorkflowElements` on agent reads, `enableLogging` on Music and Sound Effects methods, WAV output formats for Sound Effects, service account API key `disable`, and Twilio answering machine detection `actions`. - [v2.73.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.73.0) - Added `createAndWait` helpers for Flows image, video and Text to Speech generations and template runs (`client.flows.templates.runs.createAndWait`). They create the request and poll until it completes or fails, pacing requests with the server's `Retry-After` header. A `failed` result is returned rather than thrown, and `waitTimeoutInSeconds` throws `FlowsWaitTimeoutError` if the work is not finished in time. The regenerated client adds the Video to music `add_sfx`, `separate_tracks` and `use_audio_as_reference` options. #### Python SDK - [v2.74.1](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.74.1) - `music.compose_detailed` now accepts and forwards `enable_logging`, which the custom wrapper previously dropped, so Zero Retention Mode works with this method. - [v2.74.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.74.0) - Added `client.conversational_ai.realtime.create_client_secret` for the Realtime API and an `environments` client, with the same regenerated API changes as JavaScript SDK v2.74.0. - [v2.73.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.73.0) - Added `create_and_wait` helpers for Flows image, video and Text to Speech generations and template runs, for both sync and async clients, with `wait_timeout_in_seconds` and `min_poll_interval_in_seconds` options and a `FlowsWaitTimeoutError` exported from `elevenlabs.flows_custom`. Type checkers such as pyright now resolve `client.webhooks.construct_event`, `client.speech_to_text.realtime`, `client.text_to_speech.convert_realtime` and the custom Music methods. Includes the same regenerated API changes as the JavaScript SDK. - [v2.73.1](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.73.1) - Fixed the test suite on Python 3.13 and later, and added Python 3.13 and 3.14 to CI. #### ElevenLabs CLI - [v1.7.0](https://github.com/elevenlabs/cli/releases/tag/v1.7.0) - Regenerated API commands, adding environments, realtime client secrets and service account API key disabling. - [v1.6.0](https://github.com/elevenlabs/cli/releases/tag/v1.6.0) - Added `create-and-wait` commands for `flows image`, `flows video`, `flows text-to-speech` and `flows templates runs`. Each command returns a finished result, with `--wait-timeout` and `--min-poll-interval` options. - [v1.5.1](https://github.com/elevenlabs/cli/releases/tag/v1.5.1), [v1.5.2](https://github.com/elevenlabs/cli/releases/tag/v1.5.2), [v1.5.3](https://github.com/elevenlabs/cli/releases/tag/v1.5.3) and [v1.6.1](https://github.com/elevenlabs/cli/releases/tag/v1.6.1) - Bug fixes for onboarding, including Windows support. #### Packages - [@elevenlabs/client@1.28.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.28.0) - Added the experimental `persistentSession` option for resumable text conversations over WebSocket, and the `onConversationHistory` callback for the transcript the server replays on resume. WebSocket sessions now also emit `onConversationMetadata`. - [@elevenlabs/react@1.18.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.18.0) - Forwards the experimental `onConversationHistory` callback to `@elevenlabs/client`. - [@elevenlabs/types@0.25.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.25.0) - Added the `conversation_history` server event and the `persistent_session_token` field on `conversation_initiation_metadata`. - [@elevenlabs/react-native@1.2.30](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.30) - Updated to `@elevenlabs/client@1.28.0` and `@elevenlabs/react@1.18.0`. - [@elevenlabs/convai-widget-core@0.20.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.20.0) and [@elevenlabs/convai-widget-embed@0.20.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.20.0) - Added the `persistent-session` attribute. Text conversations survive a dropped connection or a page reload: the widget keeps the transcript, reopens the chat, renders the history replayed by the server and resumes the conversation. **End chat** discards the stored conversation. Workspaces without persistent sessions fall back to a standard conversation. - [@elevenlabs/convai-widget-core@0.19.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.19.1) and [@elevenlabs/convai-widget-embed@0.19.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.19.1) - First message quick replies are shown below the first message in voice calls. ### API ## New endpoints ### ElevenAgents - [Create realtime client secret](/docs/api-reference/conversations/create-client-secret) - `POST /v1/convai/realtime/client_secrets` - Create an ephemeral client secret for browser-based Realtime API sessions. Accepts an optional `session` (OpenAI-compatible session configuration with `model` of `eleven_realtime_v1_mini` (default) or `eleven_realtime_v1_max`, `instructions`, `audio`, `tools`, `turn_detection` and `max_duration_seconds` from 60 to 7,200, default 600) and optional `expires_after` with required `seconds` (integer). Returns `value` (string), `expires_at` (integer) and the echoed `session`. - [List environments](/docs/api-reference/environments/list) - `GET /v1/convai/environments` - List the workspace environments, including `production`. Each environment has `name`, nullable `updated_at_unix_secs` and nullable `created_by_user_id`. - [Create environment](/docs/api-reference/environments/create) - `POST /v1/convai/environments` - Create an environment with a required, unique `name` (string). Returns `409` if the name is taken. - [Delete environment](/docs/api-reference/environments/delete) - `DELETE /v1/convai/environments/{environment}` - Delete an environment and remove its values from all environment variables. Returns `204`. ### Workspaces - [Disable service account API key](/docs/api-reference/service-accounts/api-keys/disable) - `POST /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id}/disable` - Disable a service account API key without changing its other settings. ## Updated endpoints ### ElevenAgents - [Get agent](/docs/api-reference/agents/get), [Update agent](/docs/api-reference/agents/update), [Preview rebase](/docs/api-reference/agents/branches/preview-rebase) and [Preview merge](/docs/api-reference/agents/branches/preview-merge) - Added optional `include_procedure_generated_workflow_elements` (boolean, default `true`). When `false`, the returned workflow contains only authored nodes and edges, without those generated from structured procedures. - [Create agent](/docs/api-reference/agents/create), [Get agent](/docs/api-reference/agents/get) and [Update agent](/docs/api-reference/agents/update) - The `llm` enum adds `gemini-4-argon`, `claude-opus-4-6` and `nemotron-35-super-vl-nvfp4`. - TTS configuration `effects` removes the deprecated `seed` field. - [Delete agent](/docs/api-reference/agents/delete) - Added optional `force` (boolean, default `false`). - [List agents](/docs/api-reference/agents/list) - `sort_by` adds `updated_at`. Agent summaries add required `updated_at_unix_secs` (integer). - [Rebase branch](/docs/api-reference/agents/branches/rebase) and [Preview rebase](/docs/api-reference/agents/branches/preview-rebase) - Added optional `source_branch_id` (string). Defaults to the agent's main branch. - [Outbound call](/docs/api-reference/twilio/outbound-call), [Submit batch call](/docs/api-reference/batch-calling/create) and [Get batch call](/docs/api-reference/batch-calling/get) - Twilio machine detection configuration adds `actions`, an array of rules with required `action` (`hang_up`) and required `answered_by` (array of `human`, `fax`, `unknown`, `machine_start`, `machine_end_beep`, `machine_end_silence` or `machine_end_other`). Each action can appear in at most one rule. - [Get conversation details](/docs/api-reference/conversations/get) - Transcript tool calls add nullable `tool_id` (string). It is not set for tools without an ID, such as system tools. - Turn metrics add nullable `voice_id` (string). - Tool results add nullable `to_agent` and `to_node` (string). - WhatsApp conversation info adds nullable `recipient` with nullable `phone` and `bsuid` (string), and nullable `call_permission_request` with required `state` (`blocked`, `sent`, `accepted` or `declined`) and nullable `requested_at_unix` (integer). - The platform charge category enum adds `v3_addon`, `v4_addon` and `rag_addon`. - [Get ticket](/docs/api-reference/triage-tickets/get), [List tickets](/docs/api-reference/triage-tickets/list) and [List workspace tickets](/docs/api-reference/triage-tickets/list-for-workspace) - Ticket responses add required `status_changes`, an array of objects with `status`, nullable `changed_by_user_id` (string) and `changed_at_unix_secs` (integer). ### Text to Speech and Text to Dialogue - [Create speech](/docs/api-reference/text-to-speech/convert), [Stream speech](/docs/api-reference/text-to-speech/stream), [Create dialogue](/docs/api-reference/text-to-dialogue/convert) and [Stream dialogue](/docs/api-reference/text-to-dialogue/stream), including their timestamp variants - `use_pvc_as_ivc` is now nullable and no longer declares a default of `false`. ### Music - [Compose music](/docs/api-reference/music/compose), [Compose detailed](/docs/api-reference/music/compose-detailed), [Stream music](/docs/api-reference/music/stream), [Compose detailed stream](/docs/api-reference/music/compose-detailed-stream), [Separate stems](/docs/api-reference/music/separate-stems), [Video to music](/docs/api-reference/music/video-to-music) and `POST /v1/music/plan` - Added optional `enable_logging` query parameter (boolean, default `true`). Set it to `false` for Zero Retention Mode. - [Video to music](/docs/api-reference/music/video-to-music) - Added optional `add_sfx`, `separate_tracks` and `use_audio_as_reference` (boolean, default `false`). ### Sound Effects - [Create sound effect](/docs/api-reference/text-to-sound-effects/convert) - Added optional `enable_logging` query parameter (boolean, default `true`). - `output_format` adds `wav_8000`, `wav_16000`, `wav_22050`, `wav_24000`, `wav_32000`, `wav_44100` and `wav_48000`. ### Speech Engine - [List Speech Engines](/docs/api-reference/speech-engine/list) - `sort_by` adds `updated_at`. Summaries add required `updated_at_unix_secs` (integer). ### Speech to Text - [Create transcript](/docs/api-reference/speech-to-text/convert) and [Get transcript](/docs/api-reference/speech-to-text/get) - Edited transcripts add required, read-only `edited_text` (string), matching `text` and the `edited_text` field of the realtime `edited_transcript` event. ### Dubbing - `GET /v1/dubbing/project/{project_id}/language` and `GET /v1/dubbing/project/{project_id}/language/{language_id}` - Language outputs add nullable `subtitles` (string, signed URL). ### Voices - [Get voice](/docs/api-reference/voices/get), [List voices](/docs/api-reference/voices/search) and [Get voices](/docs/api-reference/voices/get-all) - Voice sharing `review_status` adds `declined_resubmittable`. ### Workspaces - [List workspace groups](/docs/api-reference/workspace/groups/list) and [List service accounts](/docs/api-reference/service-accounts/list) - Groups add nullable `group_concurrency_limit`, `group_dubbing_concurrency_limit` and `group_music_concurrency_limit` (integer or `unlimited`). - Group permissions add `all_resources_access`. ## October 12, 2026 ### ElevenAgents - **Merge and search triage tickets**: [Merge tickets](/docs/api-reference/triage-tickets/merge) folds up to 50 open tickets from the same agent into one target ticket. Merged tickets keep the status `merged` and reference the target through `merged_into_ticket_id`. [List tickets](/docs/api-reference/triage-tickets/list) and [List workspace tickets](/docs/api-reference/triage-tickets/list-for-workspace) add a case-insensitive `search` parameter that matches ticket titles, descriptions, comments and turn comments, and each result includes a `search_match` excerpt showing where the query matched. - **Workflow End node outcomes**: Workflow End nodes accept an `outcome` of `success` (default) or `failure`, so a workflow can record whether a conversation ended successfully. The conversation error type adds `workflow_end_failure`. - **Call queueing enabled for new agents**: New agents are created with [call queueing](/docs/eleven-agents/guides/call-queueing) enabled unless `platform_settings.queueing_config.enabled` is set explicitly. Existing agents keep their current setting. - **Post-call audio webhook retries**: When **Enable retries** is on, `post_call_audio` [webhooks](/docs/eleven-agents/workflows/post-call-webhooks) are retried on the same schedule as transcription webhooks. Audio payloads over 50 MiB are not retried, and queued audio retries are capped at 400 MiB per webhook. - **Strict tool overrides**: The conversation override `tool_ids_strict` makes an overridden `tool_ids` list the complete set of tools available in the conversation, including tools on workflow nodes. It is ignored when set on the agent itself. - **Widget end confirmation**: The widget can ask users to confirm before ending a chat or call. Enable it with `end_confirmation_enabled` in the widget configuration or the `end-confirmation` attribute. ### Text to Speech - **Audio effects**: [Text to Speech](/docs/api-reference/text-to-speech/convert) and [Text to Dialogue](/docs/api-reference/text-to-dialogue/convert) requests accept an optional `audio_effects` object. It applies a filter preset, perceived distance, a reverb environment, a looped background noise bed and stereo panning to the generated audio. List valid preset, environment and background noise IDs with `GET /v1/audio-effects/catalog`. Reverb and non-zero panning produce stereo audio and are rejected for `ulaw_*`, `alaw_*` and `pcm_*` output formats. Effects do not change the cost of a request. ### Speech to Text - **Turn prediction commit strategy**: The [realtime Speech to Text WebSocket](/docs/api-reference/speech-to-text/v-1-speech-to-text-realtime) adds `turn_prediction` as a `commit_strategy` value. In addition to silence-based segmentation, it commits a segment as soon as the model predicts the speaker has finished their turn. It is the default for models that predict turns, and partial transcripts from those models include `turn_probability`. See [transcripts and commit strategies](/docs/eleven-api/guides/how-to/speech-to-text/realtime/transcripts-and-commit-strategies). ### Voices - **Voice collections API**: Voice collections can now be managed through the API. Create, list, update and delete collections, and add or remove voices. See [List voice collections](/docs/api-reference/voices/collections/list). ### Workspaces - **Basic seat fallback**: [Update member](/docs/api-reference/workspace/members/update) accepts `allow_downgrade_to_basic_seat`. When unlocking a user whose original seat type has no seats available, the user is moved to a basic seat instead of the request failing. - **Workspace ID on user**: [Get user](/docs/api-reference/user/get) returns the `workspace_id` of the workspace the API key belongs to. ### SDK releases #### JavaScript SDK - [v2.72.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.72.0) - Added clients for voice collections, the audio effects catalog and triage ticket merging. Text to Speech and Text to Dialogue methods accept `audio_effects`, triage ticket list methods add search and filters, and the realtime Speech to Text client adds the `turn_prediction` commit strategy. #### Python SDK - [v2.72.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.72.0) - Added clients for voice collections, the audio effects catalog and triage ticket merging. Text to Speech and Text to Dialogue methods accept `audio_effects`, triage ticket list methods add search and filters, and the realtime Speech to Text client adds the `turn_prediction` commit strategy. `play()` and `save()` now accept any iterable of audio chunks, such as a list or tuple. `RealtimeEvents.CLOSE` handlers receive a dictionary with the WebSocket close `code` and `reason`; handlers without parameters continue to work. #### ElevenLabs CLI - [v1.5.0](https://github.com/elevenlabs/cli/releases/tag/v1.5.0) - Regenerated API commands, adding voice collections, the audio effects catalog, triage ticket merging and agent merge proposals. #### Packages - [@elevenlabs/client@1.27.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.27.0) and [@elevenlabs/react@1.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.17.0) - Added a `previousText` option to `Scribe.connect()` and `useScribe()` in microphone mode. The text is sent with the first audio chunk to give the model context, such as existing document text, for casing, punctuation and sentence continuation. `MediaDeviceOutput` now receives `libsampleratePath`, so output resampling uses the same custom libsamplerate bundle path as `MediaDeviceInput`. - [@elevenlabs/react-native@1.2.29](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.29) - Updated to `@elevenlabs/client@1.27.0` and `@elevenlabs/react@1.17.0`. - [@elevenlabs/convai-widget-core@0.19.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.19.0) and [@elevenlabs/convai-widget-embed@0.19.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.19.0) - Added an optional confirmation dialog before ending a chat or call, enabled with the `end-confirmation` attribute or `end_confirmation_enabled` config, with customizable text. Added carousel rich content with scrollable item cards that can include an image, subtitle, description and actions. Carousels remain in the transcript after a reply, without their actions. Rich content is now shown during voice calls when the transcript is visible. ### API ## New endpoints ### ElevenAgents - [Merge tickets](/docs/api-reference/triage-tickets/merge) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/merge` - Merge open tickets into the target ticket. Requires `source_ticket_ids` (string array, 1–50 items) and returns the target ticket. ### Voices - [List voice collections](/docs/api-reference/voices/collections/list) - `GET /v1/voices/collections` - List the voice collections the caller can access, sorted by title. - [Create voice collection](/docs/api-reference/voices/collections/create) - `POST /v1/voices/collections` - Create a collection with required `title` and `icon` (string, maximum 1,000 characters each). - [Get voice collection](/docs/api-reference/voices/collections/get) - `GET /v1/voices/collections/{collection_id}` - Retrieve a collection with its `title`, `icon` and the caller's `permission_on_resource` (`admin`, `editor`, `commenter` or `viewer`). - [Update voice collection](/docs/api-reference/voices/collections/update) - `PATCH /v1/voices/collections/{collection_id}` - Update the optional `title` or `icon`. - [Delete voice collection](/docs/api-reference/voices/collections/delete) - `DELETE /v1/voices/collections/{collection_id}` - [Add voice to collection](/docs/api-reference/voices/collections/add-voice) - `POST /v1/voices/collections/{collection_id}/voice/{voice_id}` - [Remove voice from collection](/docs/api-reference/voices/collections/remove-voice) - `DELETE /v1/voices/collections/{collection_id}/voice/{voice_id}` ### Audio effects - `GET /v1/audio-effects/catalog` - List the available `filter_presets`, `environments` and `background_noises`. Each entry has an ID, a `name` and a nullable `description`. ## Updated endpoints ### ElevenAgents - [Create agent](/docs/api-reference/agents/create), [Get agent](/docs/api-reference/agents/get) and [Update agent](/docs/api-reference/agents/update) - Workflow End nodes add `outcome` (`success` or `failure`, default `success`). The field is required in responses. - Standalone workflow agent nodes and agent transfer configurations add nullable `branch_id` (string) to target a specific branch of the destination agent. When unset, the transfer follows the target agent's traffic deployment. Transfer tool results add a `configured` branch reason. - Prompt override configurations add `tool_ids_strict` (boolean, default `false`). - TTS configuration `effects` add `pan` (number, -1 to 1, default `0`). The `seed` field is deprecated and has no effect. - [Get widget config](/docs/api-reference/widget/get) - Added `end_confirmation_enabled` (boolean, default `false`). - [List tickets](/docs/api-reference/triage-tickets/list) - Added optional `search` (string, maximum 200 characters) and `merged_into_ticket_id` (string) query parameters. - Ticket responses add nullable `merged_into_ticket_id` and nullable `search_match` with `field` (`title`, `description`, `comment` or `turn_comment`), `snippet`, `highlight_start`, `highlight_end` and nullable `turn_index`. - [List workspace tickets](/docs/api-reference/triage-tickets/list-for-workspace) - Added optional `agent_id`, `sources`, `priorities`, `sort_by` (`created_at` or `priority`, default `created_at`), `owner_user_id`, `issue_type`, `label`, `merged_into_ticket_id` and `search` query parameters. - [List tests](/docs/api-reference/tests/list) - Added optional `created_by_user_id` (string). Use `@me` for the authenticated user. - [List test invocations](/docs/api-reference/tests/test-invocations/list) - Added optional `test_id` (string), `version_id` (string), `start_time` and `end_time` (integer, Unix seconds, inclusive) query parameters. - [Update agent branch](/docs/api-reference/agents/branches/update) - Added optional `auto_rebase` (boolean). Branch responses add `auto_rebase` (boolean, default `false`). - [Get conversation details](/docs/api-reference/conversations/get) - Twilio, SIP trunk and Exotel phone call metadata add nullable `call_result` with `answered`, `voicemail`, `busy`, `no_answer` and `failed` values. - Batch call metadata adds nullable `cold_attempt` (integer) and nullable `conversation_type` (`initial`, `retry`, `callback` or `redirect`). - The conversation error type adds `workflow_end_failure`. - Knowledge base auto-sync `auto_discover` is deprecated and no longer has any effect. ### Text to Speech - [Create speech](/docs/api-reference/text-to-speech/convert), [Stream speech](/docs/api-reference/text-to-speech/stream), [Create speech with timing](/docs/api-reference/text-to-speech/convert-with-timestamps) and [Stream speech with timing](/docs/api-reference/text-to-speech/stream-with-timestamps) - Added optional nullable `audio_effects` with `filter_preset_id` (string), `distance` (number, 0–1, default `0`), `environment_id` (string), `background_noise_id` (string), `send_level` (number, 0–1, default `1`) and `pan` (number, -1 to 1, default `0`). - Unknown effect IDs return `404`. Stereo effects return `400` for `ulaw_*`, `alaw_*` and `pcm_*` output formats. ### Text to Dialogue - [Create dialogue](/docs/api-reference/text-to-dialogue/convert), [Stream dialogue](/docs/api-reference/text-to-dialogue/stream), [Create dialogue with timestamps](/docs/api-reference/text-to-dialogue/convert-with-timestamps) and [Stream dialogue with timestamps](/docs/api-reference/text-to-dialogue/stream-with-timestamps) - Added optional nullable `audio_effects`, matching the Text to Speech endpoints. ### Speech to Text - [Realtime Speech to Text](/docs/api-reference/speech-to-text/v-1-speech-to-text-realtime) - The `commit_strategy` query parameter adds `turn_prediction`, alongside `manual` and `vad`. - `partial_transcript` messages add optional `turn_probability` (number), sent only for models that predict turns. ### Music - `POST /v1/music/video-to-music` - Responses add a `song-id` header with the ID of the generated song. ### History - [List generated items](/docs/api-reference/history/list) - The history item `source` enum adds `VoicePreview`. ### Workspace and user - [Update member](/docs/api-reference/workspace/members/update) - Added optional `allow_downgrade_to_basic_seat` (boolean, default `false`). - [Get user](/docs/api-reference/user/get) - Added required `workspace_id` (string). - Service account API key permissions add `voice_collections_read` and `voice_collections_write`. ## October 5, 2026 ### ElevenAgents - **Structured procedures compile on save and publish**: [Update agent](/docs/api-reference/agents/update) and [Create agent draft](/docs/api-reference/agents/drafts/create) now compile and validate [structured procedures](/docs/eleven-agents/customization/procedures/structured-procedures) automatically. Integrations no longer need to call the compile endpoint or manually update the generated workflow. Invalid procedures return per-procedure errors as `400 procedure_validation_failed`. Agents without structured procedures are unaffected. - **Compile procedures endpoint is legacy**: [Compile procedures](/docs/api-reference/agents/procedures/compile) is marked legacy and should not be used by new integrations. It remains available for existing callers. - **Merge proposals**: Merge proposals are available in alpha. Teams can open a proposal for an agent branch, review configuration changes and test results, leave comments or approval decisions, and merge approved changes into a target branch. See [Merge proposals](/docs/eleven-agents/operate/merge-proposals). ### SDK releases #### JavaScript SDK - [v2.71.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.71.0) - Added clients for agent merge proposals, deployment history, test invocation cancellation and Speech Engine duplication. The release also adds triage ticket priorities and sorting, batch call export limits, `gpt-6.1-sol`, `claude-sonnet-5-5`, Eleven v4 agent voice models and current agent configuration types. #### Python SDK - [v2.71.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.71.0) - Added clients for agent merge proposals, deployment history, test invocation cancellation and Speech Engine duplication. The release also adds triage ticket priorities and sorting, batch call export limits, `gpt-6.1-sol`, `claude-sonnet-5-5`, Eleven v4 agent voice models and current agent configuration types. #### Swift SDK - [v3.4.0](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.4.0) - Dynamic variables now preserve native JSON types when sent in conversation initiation data. #### Packages - [@elevenlabs/client@1.26.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.26.0), [@elevenlabs/react@1.16.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.16.0), [@elevenlabs/react-native@1.2.28](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.28) and [@elevenlabs/types@0.24.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.24.0) - Added realtime Speech to Text transcript editing through `transcriptEdit`, the `edited_transcript` event and React's `onEditedTranscript` callback. React now forwards `filterBackgroundAudio` to realtime sessions. The client also exports `MessagePayload` and uses stable response IDs to prevent duplicate agent replies. - [@elevenlabs/convai-widget-core@0.18.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.18.3) and [@elevenlabs/convai-widget-embed@0.18.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.18.3) - Added image previews and download links for agent message attachments, including attachment-only replies. Stable response IDs prevent duplicate replies, and text-only conversations now use a stop control with an **End chat** tooltip. ### API ## New endpoints ### ElevenAgents - [Create a merge proposal](/docs/api-reference/agents/merge-proposals/create) - `POST /v1/convai/agents/{agent_id}/merge-proposals` - Create a proposal with required `source_branch_id`, `target_branch_id` and `title` fields, plus an optional description, reviewer IDs and triage ticket ID. - [List merge proposals](/docs/api-reference/agents/merge-proposals/list) - `GET /v1/convai/agents/{agent_id}/merge-proposals` - List proposals with status, source branch, target branch and text filters, plus cursor pagination. - [Get a merge proposal](/docs/api-reference/agents/merge-proposals/get) - `GET /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}` - Retrieve a proposal and its review, comment and outcome details. - [Update a merge proposal](/docs/api-reference/agents/merge-proposals/update) - `PATCH /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}` - Update its title, description or requested reviewers, or close it without merging. - [Review a merge proposal](/docs/api-reference/agents/merge-proposals/submit-review) - `POST /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}/reviews` - Submit an `approved` or `changes_requested` decision with an optional comment. - [Comment on a merge proposal](/docs/api-reference/agents/merge-proposals/add-comment) - `POST /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}/comments` - Add a Markdown comment of up to 4,096 characters. - [Merge a merge proposal](/docs/api-reference/agents/merge-proposals/merge) - `POST /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}/merge` - Merge the source branch and optionally control forced conflict resolution and source branch archival. - [List agent deployments](/docs/api-reference/agents/deployments/list) - `GET /v1/convai/agents/{agent_id}/deployments` - List current and historical branch traffic splits with page-based pagination. - [Cancel a test invocation](/docs/api-reference/tests/test-invocations/cancel) - `POST /v1/convai/test-invocations/{test_invocation_id}/cancel` - Cancel a running test invocation. ### Speech Engine - [Duplicate a Speech Engine](/docs/api-reference/speech-engine/duplicate) - `POST /v1/speech-engine/{speech_engine_id}/duplicate` - Duplicate a Speech Engine and optionally assign the copy a new `name`. ## Updated endpoints ### ElevenAgents - [Create agent](/docs/api-reference/agents/create), [Get agent](/docs/api-reference/agents/get) and [Update agent](/docs/api-reference/agents/update) - Added `gpt-6.1-sol` and `claude-sonnet-5-5` to the `LLM` enum. - Added `eleven_v4` and `eleven_v4_turbo` to the conversational TTS model options. The default changed from `eleven_flash_v2` to `eleven_v4_turbo`. - Agent transfers and standalone workflow agent nodes add optional `preserve_voice_settings` (boolean, default `false`) to retain the base voice, TTS model and voice settings after a transfer. - Skip-turn tool configurations add optional `wait_timeout_secs` (number, default `-1`). A value of `-1` keeps the agent silent until the caller speaks. - Post-call webhook configurations add optional `exclude_transcript` (boolean, default `false`) to omit turn-by-turn transcripts from JSON transcription webhooks. - Conversation history redaction configurations add optional `excluded_data_collection_ids` (string array, maximum 50) to preserve selected extracted values while redacting their rationales. - Client tool `response_timeout_secs` now accepts `-1` to wait indefinitely when `expects_response` is enabled. - [List tickets](/docs/api-reference/triage-tickets/list) - Added optional `priorities` (array) with `low`, `medium`, `high` and `urgent` values. - Added `sort_by` with `created_at` and `priority` values; the default is `created_at`. - Ticket responses now require `title`, nullable `priority`, and a `priority_changes` array. Ticket creation and update requests can set `priority`, and ticket status adds `cancelled`. - [List tools](/docs/api-reference/tools/list) - Added optional nullable `used_by_agent_id` (string) to return tools referenced by an agent's main branch. - [Export batch call results](/docs/api-reference/batch-calling/export) - Added optional nullable `limit` (integer, minimum `1`) to export only the first recipients as a column preview. - [List test invocations](/docs/api-reference/tests/test-invocations/list) and [Get test invocation](/docs/api-reference/tests/test-invocations/get) - Test invocation summaries add required `cancelled_count` (integer) and optional `cancelled` (boolean, default `false`). - Test run status adds `cancelled`. - [Get conversation details](/docs/api-reference/conversations/get) - Transcript entries add optional nullable `platform_event` with `user_turn_timeout` and `skip_turn_wait_elapsed` values. - [Get agent version metadata](/docs/api-reference/agents/versions/get) - Added optional nullable `merged_authors`, an array describing the people who published changes merged into the main branch. - [Get crawl job](/docs/api-reference/knowledge-base/get-crawl-job) - Removed the deprecated `max_depth` response field. ## September 28, 2026 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`。 对比两个模型版本、语音克隆行为、设置和支持的语言。 使用 Eleven v4 生成高质量对话。 通过 WebSocket 连接流式传输 Eleven v4 Turbo 对话。 ### 语音转文字 - **转录编辑**：批量和实时转录现可接受最长 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 ## 新增端点 ### 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`。 ## September 23, 2026 ### 图像和视频 - **Sora 2 和 Sora 2 Pro 已停用**：OpenAI 将于 2026 年 9 月 24 日停止 Sora API 服务。两个模型已从图像和视频模型选择器中移除，并将于该日期停止生成。现有生成内容仍可在历史记录中查看。使用 Sora 节点的 Flows 和模板需切换到其他视频模型，例如[ Gemini Omni 1.1 Flash](/docs/zh/overview/capabilities/image-video)，才能再次运行。 - **Seedance 1.5 Pro 已弃用**：ByteDance 将于 2026 年 11 月 11 日停止 Seedance 1.5 Pro 服务。该模型不再提供给新的生成任务，并将于该日期停止运行。请改用 [Seedance 2.0 模型](/docs/zh/overview/capabilities/image-video)。 ## September 21, 2026 ### ElevenAgents - **并行工具调用**：智能体提示词配置现包含 `enable_parallel_tool_calls`（布尔值，默认 `true`）。启用后，支持的模型可在一次轮次中执行多个工具。 - **智能体模型**：智能体 LLM 选项新增 `gpt-6-astra`。 - **告警**：智能体告警现支持 Slack 频道，以及 PagerDuty 和 webhook 通知器。 - **电话号码搜索**：新增基于游标分页的电话号码端点，可按提供商、外呼支持、已分配智能体和分支、标签及电话号码筛选。 ### 图像和视频 - **GPT Image 2.5 模型**：[图像生成](/docs/zh/api-reference/flows/image/create)现支持 `gpt-image-2.5-flare` 和 `gpt-image-2.5-sunburst`。两个模型均最多支持 10 张参考图像，质量级别最高可选 `max`，支持 14 种固定宽高比及 `auto`，并可输出 1K、2K 或 4K。 ### 语音引擎 - **级联超时**：语音引擎创建和更新请求现接受 `cascade_timeout_seconds`（数字，2–15，默认 `4`），用于控制 ElevenLabs 在重试前等待上游语音引擎的时长。 ### 文本转语音 - **多上下文轮次边界**：现会在该轮次的每个缓冲字节后发送 `is_final_audio_for_turn` 标记，包括 MP3 和 Opus 输出。客户端无需切换到 PCM，即可将此标记用作精确的轮次边界。 ### SDK 发布 #### JavaScript SDK - [v2.69.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.69.0) - 在实时文本转语音封装器中新增 `transcriptEdit`，编辑后的文本通过 `edited_transcript` 事件发送。修复带数据驻留后缀的 API 密钥的语音引擎 JWT 验证问题。新增 `phoneNumbers.listV2` 和 Flows 模板方法，可列出和获取模板，以及列出、创建和获取运行。重新生成了 GPT Image 2.5、Slack 智能体告警、并行工具调用、`gpt-6-astra`、服务账户 API 密钥并发限制、Music 零保留、对话筛选器和 MCP 工具审批状态的客户端和类型。 #### Python SDK - [v2.69.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.69.0) - 在实时文本转语音封装器中新增 `transcript_edit`，编辑后的文本通过 `edited_transcript` 事件发送。修复带数据驻留后缀的 API 密钥的语音引擎 JWT 验证问题，并让 `play` 在 `ffplay` 失败时抛出错误。新增 `phone_numbers.list_v2` 和 Flows 模板方法，可列出和获取模板，以及列出、创建和获取运行。重新生成了 GPT Image 2.5、Slack 智能体告警、并行工具调用、`gpt-6-astra`、服务账户 API 密钥并发限制、Music 零保留、对话筛选器和 MCP 工具审批状态的客户端和类型。 #### ElevenLabs CLI - [v1.3.2](https://github.com/elevenlabs/cli/releases/tag/v1.3.2) - 新增可选 `--intent` 元数据，以收集 CLI 使用反馈。新增 `elevenlabs feedback missing-capability`，用于报告 CLI 不支持的工作流程。 ### API ## 新增端点 ### ElevenAgents - [列出电话号码页面](/docs/zh/api-reference/phone-numbers/list-v-2) - `GET /v1/convai/v2/phone-numbers` - 新增可选 `page_size`（整数，1–1,000，默认 `100`）和 `cursor`（可为空的字符串）分页参数。 - 新增可选 `search`、`label`、`phone_number`、`provider`、`supports_outbound`、`agent_id`、`branch_id`、`sort_by` 和 `sort_direction` 筛选器。`sort_by` 接受 `label` 或 `phone_number`；`sort_direction` 默认为 `asc`。 - 响应包含必填 `phone_numbers`（数组）、可选且可为空的 `next_cursor`（字符串）和 `has_more`（布尔值，默认 `false`）。 ## 更新的端点 ### ElevenAgents - [创建智能体](/docs/zh/api-reference/agents/create)、[获取智能体](/docs/zh/api-reference/agents/get) 和 [更新智能体](/docs/zh/api-reference/agents/update) - 提示词配置新增 `enable_parallel_tool_calls`（布尔值，默认 `true`）。工作流程覆盖项接受可为空的布尔值。 - `LLM` 枚举新增 `gpt-6-astra`，包括对话发起覆盖项。 - 告警集成通知器现使用 `integration_type` 选择 `pagerduty` 或 `slack`。Slack 通知器需要 `connection_id` 和 `channel_id`（字符串）；`channel_id` 接受 1–64 个字符。 - [列出对话](/docs/zh/api-reference/conversations/list)和[解析对话引用](/docs/zh/api-reference/conversations/resolve) - `data_collection_params` 不再接受 `missing` 运算符。请使用空值来匹配未收集该字段的对话。 - `dynamic_variable_params` 中的空值可匹配未设置该变量的对话。 - [创建语音引擎](/docs/zh/api-reference/speech-engine/create)、[获取语音引擎](/docs/zh/api-reference/speech-engine/get) 和 [更新语音引擎](/docs/zh/api-reference/speech-engine/update) - 新增 `cascade_timeout_seconds`（数字，2–15）。创建请求默认值为 `4`，更新请求接受可为空的值，响应要求包含该字段。 ### 图像和视频 - [创建图像生成](/docs/zh/api-reference/flows/image/create) - `POST /v1/flows/image` - 为 `gpt-image-2.5-flare` 和 `gpt-image-2.5-sunburst` 新增请求变体。 - 两种变体均需要 `prompt` 和 `model_id`，最多接受 10 个 `images`，并新增 `resolution`（`1K`、`2K` 或 `4K`，默认 `1K`）。 - `quality` 接受 `low`、`medium`、`high`、`xhigh` 或 `max`，默认为 `high`。`aspect_ratio` 接受 `auto` 和 14 种固定比例，默认为 `16:9`。 ### 配音 - [创建配音项目](/docs/zh/api-reference/dubbing/create-project) - `POST /v1/dubbing/project` - Multipart `keyterms` 接受重复字段或单个 JSON 数组。 - Multipart `webhook_ids` 接受重复字段、单个 JSON 数组或逗号分隔字符串。 - [获取工作区资源](/docs/zh/api-reference/workspace/resources/get)、[共享工作区资源](/docs/zh/api-reference/workspace/resources/share) 和 [取消共享工作区资源](/docs/zh/api-reference/workspace/resources/unshare) - `WorkspaceResourceType` 新增 `dubbing_project`。 ### 知识库 - [创建爬取任务](/docs/zh/api-reference/knowledge-base/create-crawl-job) - `POST /v1/convai/knowledge-base/crawl` - 已弃用 `max_depth`（整数，默认 `3`）。该字段现无实际作用，且不再有最小或最大限制。 - 爬取任务元数据不再要求 `max_depth`。 ### 用户 - [获取用户](/docs/zh/api-reference/user/get)和[获取订阅](/docs/zh/api-reference/user/subscription/get) - 货币枚举新增 `gbp`。 ## 架构变更 ### 文本转语音 - 多上下文 WebSocket `audio` 和 `final` 消息现将 `is_final_audio_for_turn` 定义为：在该轮次的所有缓冲字节均已发送后发生。 ## September 14, 2026 ### ElevenAgents - **通话排队和等待音频**：为达到并发上限的智能体新增[通话排队](/docs/zh/eleven-agents/guides/call-queueing)。排队中的来电者会听到等待音频，并持续收到 `queue_status` 事件，直至接入或超时。新增 API 方法可上传或删除自定义等待音频。 - **测试版本元数据**：智能体测试结果现在会标识其运行所针对的智能体版本，以及是否包含草稿更改。调用摘要还会标识部分重新提交是否针对不同版本运行。 - **模型和账户元数据**：智能体 LLM 配置现支持 `gemini-3.8-flash`。WhatsApp 账户响应会标识账户使用 Cloud API 还是共存注册流程。 ### 音乐 - **Music v2.5 API 支持**：音乐端点和 SDK 现支持 `music_v2_5`。乐曲方案生成分块最多支持 6,132 个字符，最多 30 行，每行 200 个字符。 ### SDK 发布 #### JavaScript SDK - [v2.68.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.68.0) - 新增上传和删除智能体等待音频的方法。重新生成了通话排队、流程引用、草稿分支创建、RAG 查询限制、测试版本元数据、`gemini-3.8-flash` 和 `music_v2_5` 的类型。 #### Python SDK - [v2.68.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.68.0) - 新增同步和异步上传、删除智能体等待音频的方法。重新生成了通话排队、流程、草稿分支创建、RAG 查询限制、测试版本元数据、`gemini-3.8-flash` 和 `music_v2_5` 的类型。`compose_detailed` 封装器现支持所有已生成的音乐模型 ID，以及基于提示词和分块的乐曲方案。 #### iOS SDK - [v3.3.1](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.3.1) - 现按 `response_id` 而非 `event_id` 协调智能体消息，可保留工具调用前后的多个响应，并防止流式片段或修正内容附加到错误的消息。 #### ElevenLabs CLI - [v1.3.0](https://github.com/elevenlabs/cli/releases/tag/v1.3.0) - 为生成的 API 命令新增可选 `--intent` 元数据。新增 `elevenlabs feedback missing-capability`，用于报告 CLI 不支持的工作流程。 #### 软件包 - [@elevenlabs/convai-widget-core@0.18.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.18.2) 和 [@elevenlabs/convai-widget-embed@0.18.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.18.2) - 修复工具和流程调用后出现重复智能体回复的问题。流式文本回复会保留 Markdown 格式，语音对话也不再渲染未说出的流式聊天片段。嵌入软件包还将 `user_activity` 事件限制为每秒一次，并在会话结束时清除该限制。 ### API ## 新增端点 ### ElevenAgents - [上传智能体等待音频](/docs/zh/api-reference/agents/hold-audio/create) - `POST /v1/convai/agents/{agent_id}/hold-audio` - 接受必填的 `hold_audio_file`（二进制）作为 multipart 表单数据。文件必须为 MP3 或 WAV，最大 40 MB、180 秒。 - 返回必填的 `agent_id`（字符串）和 `hold_audio`（`AgentHoldAudioConfig`）。等待音频对象需要 `audio_path`、`audio_url`、`original_filename`（字符串）、`duration_secs`（数字）和 `size_bytes`（整数）。 - [删除智能体等待音频](/docs/zh/api-reference/agents/hold-audio/delete) - `DELETE /v1/convai/agents/{agent_id}/hold-audio` - 删除自定义片段，使排队来电者听到默认等待音。 - 返回必填的 `agent_id`（字符串）。 ## 更新的端点 ### ElevenAgents - [创建智能体](/docs/zh/api-reference/agents/create)、[获取智能体](/docs/zh/api-reference/agents/get) 和 [更新智能体](/docs/zh/api-reference/agents/update) - 新增可选 `platform_settings.queueing_config`（`AgentQueueingConfig`），包含 `enabled`（布尔值，默认 `false`）和 `wait_timeout_seconds`（整数，1–1,800，默认 `180`）。 - 队列配置响应包含只读、可为空的 `hold_audio`（`AgentHoldAudioConfig`）。智能体响应还包含可选 `default_hold_audio_url`（字符串）。 - [获取对话](/docs/zh/api-reference/conversations/get) - `GET /v1/convai/conversations/{conversation_id}` - 元数据新增可选、可为空的 `queue_wait_secs`（数字）。排队时间不计入 `call_duration_secs` 和计费时长。 - [创建智能体分支](/docs/zh/api-reference/agents/branches/create) - `POST /v1/convai/agents/{agent_id}/branches` - 新增可选 `include_draft`（布尔值，默认 `false`）。设为 `true` 时，从分支顶端创建的分支会包含调用方的草稿流程集。 - [列出流程](/docs/zh/api-reference/agents/procedures/list)以及流程创建、获取和草稿端点 - 列表项新增可选 `referenced_tool_ids`、`referenced_kb_ids`、`referenced_procedure_ids` 和 `referenced_dynamic_variables`（字符串数组）。 - 智能体和合并预览响应新增可选 `procedures`，这是一个以流程 ID 为键的映射。 - [列出测试调用](/docs/zh/api-reference/tests/test-invocations/list) - `GET /v1/convai/test-invocations` - 新增可选、可为空的 `search`（字符串），可按名称筛选测试和文件夹。 - [在智能体上运行测试](/docs/zh/api-reference/tests/run-tests)和[获取测试调用](/docs/zh/api-reference/tests/test-invocations/get) - 测试套件调用和单元测试运行响应新增可选、可为空的 `version_id`（字符串）以及可选 `ran_against_draft`（布尔值，默认 `false`）。 - 调用摘要还新增可选 `runs_diverged_from_version`（布尔值，默认 `false`）。 - `POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query` - 请求正文新增可选、可为空的查询专用覆盖项 `max_documents_length`（整数，1–50,000）和 `max_retrieved_rag_chunks_count`（整数，1–20）。 - [获取 WhatsApp 账户](/docs/zh/api-reference/whats-app/accounts/get) - `GET /v1/convai/whatsapp-accounts/{phone_number_id}` - 新增可选 `account_type`（`WhatsAppAccountType`，默认 `cloud_api`）。可选值为 `cloud_api` 和 `coexistence`。 - [计算预期 LLM 用量](/docs/zh/api-reference/agents/calculate) - `POST /v1/convai/agent/{agent_id}/llm-usage/calculate` - `LLMUsageCalculatorLLMResponseModel` 新增必填 `price_per_message`（数字）。 ### 音乐 - `MusicModelID` 为 `POST /v1/music/video-to-music`、`POST /v1/music/plan`、[创作音乐](/docs/zh/api-reference/music/compose)、`POST /v1/music/detailed`、`POST /v1/music/detailed/stream`、`POST /v1/music/stream`、`POST /v1/music/upload` 和 `POST /v1/music/finetunes` 新增 `music_v2_5`。 - 对于 `POST /v1/music/plan`、`POST /v1/music`、`POST /v1/music/detailed`、`POST /v1/music/detailed/stream`、`POST /v1/music/stream` 和 `POST /v1/music/upload`，`GenerationChunk.text` 的 `maxLength` 从 6,000 个字符提高到 6,132 个字符。段落名称可包含 1–100 个字符，分块最多可包含 30 行，每行 200 个字符。 ## 架构变更 ### ElevenAgents - 实时服务器事件新增 `queue_status`。其必填 `queue_status_event.status` 接受 `waiting`、`admitted` 或 `timed_out`；`timed_out` 会先于 WebSocket 关闭代码 `4300` 发生。等待音频仍作为常规 `audio` 事件发送。 - `LLM` 枚举新增 `gemini-3.8-flash`，包括对话发起覆盖项。 - 对话系统工具结果联合类型新增 `start_procedure_success`、`start_procedure_error`、`end_procedure_success` 和 `end_procedure_error`。 - `FeaturesUsageCommonModel` 新增可选 `freeform_procedure` 和 `structured_procedure` 功能状态。 ## September 11, 2026 ### Scribe v2 Medical [Scribe v2 Medical](/docs/zh/overview/models#scribe-v2-medical) 现已正式发布。这是一款专为医疗和临床音频设计的批量语音识别模型，计费标准与 Scribe v2 相同。 在[创建转录文本](/docs/zh/api-reference/speech-to-text/convert)时，将 `model_id` 设为 `scribe_v2_medical`。关键词提示、实体检测、说话人分离和非逐字模式的使用方式与 Scribe v2 相同。 模型 ID、功能以及适合使用 Scribe v2 Medical 的场景。 将 `model_id` 设为 `scribe_v2_medical`，即可转录音频。 ## September 7, 2026 ### ElevenAgents - **工作区范围的对话工单**：新增[列出工作区工单](/docs/zh/api-reference/triage-tickets/list-for-workspace)，可获取有访问权限的智能体中的对话分诊工单。可按状态或负责人筛选，并使用游标分页，每页最多获取 100 个工单。 - **动态变量对话筛选**：[列出对话](/docs/zh/api-reference/conversations/list)和[文本搜索对话消息](/docs/zh/api-reference/conversations/messages/text-search)现接受可重复的 `dynamic_variable_params` 筛选条件。使用 `name:op:value` 格式，`op` 可为 `eq`、`gt`、`gte`、`lt` 或 `lte`；比较运算符要求值为数值。 - **Twilio 答录机检测**：外呼电话和批量呼叫配置现支持可选的 `twilio_machine_detection`。选择 `enable` 可尽早判断是人工还是机器，选择 `detect_message_end` 则等待语音信箱问候语结束。结果将通过新的 `answering_machine_detection` webhook 事件送达。 - **数据收集值约束**：数据收集属性现可使用 `allowed_values` 指定一个包含允许值的动态变量。此前的 `allowed_values_dynamic_variable` 字段已弃用。 - **智能体元数据**：[列出智能体分支](/docs/zh/api-reference/agents/branches/list)响应现会指明草稿的创建时间，以及它是否早于分支最新提交。智能体和语音引擎摘要现在要求提供 `voice_id`。 - **知识库源 URL**：智能体 RAG 查询分块现包含必需且可为 null 的 `source_url`，其中包含 URL 文档的追踪 URL。 - **智能体响应附件**：`agent_response` WebSocket 事件现包含可选的 `attachments`。每个附件都需要 `url` 和 `name`，并可包含 `mime_type`。 ### 工作区 - **API 密钥平台限制**：服务账号 API 密钥响应现可包含企业版 `platform_limits`，涵盖额度、专业语音克隆，以及 TTS、配音和音乐的并发限制。 ### SDK 发布 #### JavaScript SDK - [v2.67.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.67.0) - 在对话列表和文本搜索请求中添加 `dynamicVariableParams`。重新生成 Twilio 答录机检测、数据收集值约束、API 密钥平台限制、智能体分支草稿元数据和知识库源 URL 的类型。 #### Python SDK - [v2.67.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.67.0) - 在同步和异步对话列表及文本搜索方法中添加 `dynamic_variable_params`。重新生成 Twilio 答录机检测、数据收集值约束、API 密钥平台限制、智能体分支草稿元数据和知识库源 URL 的类型。实时文本转语音客户端不再将内部 omit sentinel 传递给连接。 #### ElevenLabs CLI - [v1.2.0](https://github.com/elevenlabs/cli/releases/tag/v1.2.0) - 添加 `elevenlabs say` 命令及其智能体技能，重新生成 API 命令绑定，并将 `eleven_v3` 设为默认 TTS 模型。 #### 软件包 - [@elevenlabs/client@1.25.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.25.0)、[@elevenlabs/react@1.15.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.15.2)、[@elevenlabs/react-native@1.2.27](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.27)、[@elevenlabs/convai-widget-core@0.18.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.18.1) 和 [@elevenlabs/convai-widget-embed@0.18.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.18.1) - 从 `@elevenlabs/client` 重新导出 `MessageAttachment`，以便使用者直接导入该类型。 - [@elevenlabs/client@1.24.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.24.0)、[@elevenlabs/types@0.23.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.23.0)、[@elevenlabs/react@1.15.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.15.1)、[@elevenlabs/react-native@1.2.26](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.26)、[@elevenlabs/convai-widget-core@0.18.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.18.0) 和 [@elevenlabs/convai-widget-embed@0.18.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.18.0) - 将智能体响应文件附件转发至 `onMessage`，并新增可选的 `webRtc.singlePeerConnection` 会话设置。组件还对问候按钮进行了本地化，并修复了文本聊天响应丢失或重复的问题。 ### API ## 新增端点 ### ElevenAgents - [列出工作区工单](/docs/zh/api-reference/triage-tickets/list-for-workspace) - `GET /v1/convai/triage-tickets` - 列出调用方有权访问的所有智能体中的对话分诊工单，按创建时间从近到远排序。 - 添加可选的 `page_size`（整数，1–100，默认 `100`）、`status`（`AgentConversationTicketStatus`）、`assignee_user_id`（字符串或 `unassigned`）和 `cursor`（字符串）查询参数。 - 返回 `GetAgentConversationTicketsPageResponseModel`。 ## 已更新端点 ### ElevenAgents - [列出对话](/docs/zh/api-reference/conversations/list) - `GET /v1/convai/conversations` - 添加可选且可为 null 的 `dynamic_variable_params`（可重复字符串数组）。每个值使用 `name:op:value` 格式，其中 `op` 为 `eq`、`gt`、`gte`、`lt` 或 `lte`。 - [文本搜索对话消息](/docs/zh/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search` - 添加具有相同语法的可选且可为 null 的 `dynamic_variable_params`（可重复字符串数组）。 - [Twilio 外呼](/docs/zh/api-reference/twilio/outbound-call)、[SIP 中继外呼](/docs/zh/api-reference/sip-trunk/outbound-call)、[Exotel 外呼](/docs/zh/api-reference/exotel/outbound-call)和[提交批量呼叫](/docs/zh/api-reference/batch-calling/submit) - `telephony_call_config` 现使用独立的输入和输出 schema。 - 添加可选且可为 null 的 `twilio_machine_detection`（`TwilioMachineDetectionConfig`）。其 `mode` 接受 `enable` 或 `detect_message_end`，默认值为 `enable`。非 Twilio 服务商和呼入电话会忽略此设置。 - [导入电话号码](/docs/zh/api-reference/phone-numbers/create) - `POST /v1/convai/phone-numbers` - 为 Twilio API 密钥导入添加可选且可为 null 的 `account_auth_token`（字符串），用于验证呼入 webhook 签名。 ## Schema 变更 ### ElevenAgents - `WebhookEventType` 新增 `answering_machine_detection`。 - `AgentBranchSummary` 新增可选且可为 null 的 `draft_created_at`（整数）和可选的 `draft_is_behind_tip`（布尔值，默认 `false`）。 - `AgentKnowledgeBaseRagChunkResponseModel` 新增必需且可为 null 的 `source_url`（字符串）。 - `AgentSummaryResponseModel` 和 `SpeechEngineSummaryResponse` 新增必需的 `voice_id`（字符串）。 - `AnalysisProperty` 新增可选且可为 null 的 `name`（字符串）和 `allowed_values`（`AllowedValues`）。`LiteralJsonSchemaProperty` 也新增 `allowed_values`。两者均弃用 `allowed_values_dynamic_variable`。 - `DataCollectionResultCommonModel` 新增可选且可为 null 的 `name`（字符串）。 - `WorkspaceApiKeyResponseModel` 新增可选且可为 null 的 `platform_limits`（`PlatformLimits`）。 - MCP 工具 `Icon` 新增可选且可为 null 的 `theme`（`light` 或 `dark`）。 - `SMBToolConfig` 新增 `send_custom_email`、`create_service_quote_request` 和 `create_product_quote_request` 参数变体。 - Webhook 查询参数 schema 和电话呼叫配置现使用独立的输入和输出模型。 - `agent_response` WebSocket 事件新增可选的 `attachments`（数组）。每项都需要 `url` 和 `name`（字符串），并接受可选的 `mime_type`（字符串）。 ### ElevenCreative - `ReferenceVideo.studio_clip` 现使用 `StudioClipLocator` 替代 `StudioClipReference`。字段和线缆格式保持不变。 ## August 31, 2026 ### 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/` 追加到 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 ## 已更新端点 ### 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`。 ## August 24, 2026 import { YoutubeEmbed } from "../../../components/YoutubeEmbed"; ### ElevenLabs CLI [ElevenLabs CLI v1.0.0](https://github.com/elevenlabs/cli/releases/tag/v1.0.0) 现已推出。每项 ElevenLabs API 操作都可作为子命令使用，支持 JSON、表格、YAML 和 CSV 输出、自动分页及 shell 补全。 CLI 还为 ElevenAgents 提供本地配置 workflow。可将智能体、工具和测试配置存为文件，通过 push 和 pull 命令同步，管理分支、运行测试、安装 ElevenLabs UI 组件，并选择数据驻留区域。 安装 CLI、进行身份验证，并以代码方式管理智能体。 ### 操作流程 操作流程现已在 ElevenAgents 中正式推出。操作流程包含针对特定任务的说明，以及决定何时应用这些说明的触发条件。对话期间，智能体会加载相关操作流程，让同一智能体无需将所有说明写入系统提示词，即可处理不同任务。 当智能体可以根据对话调整说明措辞或顺序时，请使用自由形式操作流程。需要按指定顺序执行步骤时，请使用结构化操作流程。两种类型都可与同一智能体上的 workflow 配合使用。 了解何时使用操作流程，以及它们与提示词和 workflow 的区别。 编写智能体可根据对话调整的自然语言说明。 定义智能体按一致顺序执行的类型化步骤。 ### ElevenAgents - **对话分诊工单**：新增 API，可创建关于智能体表现的工单、创建手动跟进工单、列出工单、分配工作区成员、更新状态和受理人，以及添加工单级或轮次级评论。 - **对话可观测性**：实时客户端可在每次智能体轮次完成后接收 `context_usage` 事件。该事件会报告模型、提示词 token 数和模型上下文限制。 ### SDK 版本发布 #### JavaScript SDK - [v2.65.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.65.0) - 新增对话分诊工单和轻量级对话摘要的客户端及类型。对话 API 新增操作流程、无效工具调用和排序筛选；操作流程 API 新增智能体版本选择；主题 API 新增评估详情控制和挫败感排序。此版本还新增知识库刷新频率、测试环境和告警集成字段，以及实时配音消息类型。 #### Python SDK - [v2.65.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.65.0) - 新增对话分诊工单和轻量级对话摘要的客户端及类型。对话 API 新增操作流程、无效工具调用和排序筛选；操作流程 API 新增智能体版本选择；主题 API 新增评估详情控制和挫败感排序。此版本还新增知识库刷新频率、测试环境和告警集成字段，并保留语音转文本 `keyterms` 和配音 `webhook_ids` 的重复 multipart 字段。 #### Swift SDK - [v3.3.0](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.3.0) - 新增类型化客户端错误解析、`expects_response` 处理和类型安全的工具结果。WebRTC 启动现在会在智能体加入时就绪，无需等待音轨订阅。此版本还增强了 URL 处理，抑制未知事件噪声，并从软件静音处理移除了实时线程分配。 #### 软件包 - [@elevenlabs/client@1.19.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.19.1), [@elevenlabs/react@1.12.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.3), [@elevenlabs/react-native@1.2.21](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.21), [@elevenlabs/convai-widget-core@0.16.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.2) 和 [@elevenlabs/convai-widget-embed@0.16.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.2) - 在严格内容安全策略下，WebRTC 输出捕获现在使用自托管的 AudioWorklet 路径。Worklet 缓存包含请求的源，避免较早的内联 URL 替换自托管路径。React Native 设置错误现在会指向 `@elevenlabs/react-native`。 - [@elevenlabs/client@1.20.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.20.0), [@elevenlabs/react@1.12.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.4), [@elevenlabs/react-native@1.2.22](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.22), [@elevenlabs/convai-widget-core@0.16.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.3) 和 [@elevenlabs/convai-widget-embed@0.16.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.3) - 新增可选的 `webRtc.iceTransportPolicy`。在阻止直接 UDP 流量的网络中，将其设为 `relay`，可将 WebRTC ICE 候选限制为 TURN 中继。 - [@elevenlabs/client@1.21.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.21.0), [@elevenlabs/react@1.13.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.13.0), [@elevenlabs/types@0.21.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.21.1), [@elevenlabs/react-native@1.2.23](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.23), [@elevenlabs/convai-widget-core@0.16.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.4) 和 [@elevenlabs/convai-widget-embed@0.16.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.4) - 新增 `onContextUsage` 回调和 `ContextUsageEvent` 类型。React 通过 `useConversation` 提供该回调。React Native 现在通过其软件包导出条件解析，而非检测浏览器全局变量。 - [@elevenlabs/client@1.22.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.22.0), [@elevenlabs/react@1.14.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.14.0), [@elevenlabs/types@0.22.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.22.0), [@elevenlabs/react-native@1.2.24](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.24), [@elevenlabs/convai-widget-core@0.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.17.0) 和 [@elevenlabs/convai-widget-embed@0.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.17.0) - 新增带归因按钮响应的首条消息富内容、`onExternalAgentDisconnected` 和 `onMCPToolApprovalRequest`。WebRTC 现在使用所选输入设备，切换麦克风时保留静音状态，并会在无法发送初始化数据时终止设置。小组件新增并发队列状态、可选的折叠触发器语言选择，以及对同时支持文本和语音的智能体的首条消息渲染。 ### API ## 新增端点 ### ElevenAgents - 新增 9 个对话分诊工单端点： - [创建对话工单](/docs/zh/api-reference/triage-tickets/create-agent-conversation-ticket-route) - `POST /v1/convai/triage-tickets`。请求需要 `conversation_id`（字符串），并接受 `qa_comment`（可为 null 的字符串，1–10,000 个字符）以及最多 200 条轮次评论。 - [列出工单](/docs/zh/api-reference/triage-tickets/list-agent-conversation-tickets-route) - `GET /v1/convai/agents/{agent_id}/triage-tickets`，支持游标分页。 - [创建手动工单](/docs/zh/api-reference/triage-tickets/create-manual-agent-ticket-route) - `POST /v1/convai/agents/{agent_id}/triage-tickets`。请求需要 `qa_comment`（字符串，1–10,000 个字符）。 - [列出可分配用户](/docs/zh/api-reference/triage-tickets/get-assignable-users-route) - `GET /v1/convai/agents/{agent_id}/triage-tickets/assignable-users`。响应会列出非服务账号的工作区成员，以及每位成员是否有权访问该智能体。 - [获取工单](/docs/zh/api-reference/triage-tickets/get-agent-conversation-ticket-route) - `GET /v1/convai/triage-tickets/{agentqa_ticket_id}`。 - [更新工单](/docs/zh/api-reference/triage-tickets/update-agent-conversation-ticket-route) - `PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}`。请求接受可选的 `status` 和可为 null 的 `assignee_user_id`。 - [删除工单](/docs/zh/api-reference/triage-tickets/delete-agent-conversation-ticket-route) - `DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}`。 - [添加评论](/docs/zh/api-reference/triage-tickets/add-ticket-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments`。请求需要 `comment`（字符串，1–10,000 个字符）。 - [添加轮次评论](/docs/zh/api-reference/triage-tickets/add-turn-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments`。请求需要从 0 开始的 `turn_index`（整数）和 `comment`（字符串，1–10,000 个字符）。 ## 更新的端点 ### ElevenAgents - [获取签名 URL](/docs/zh/api-reference/conversations/get-signed-url) - `GET /v1/convai/conversation/get-signed-url` - 新增可选的 `debug_events_request`（布尔值，默认 `false`）。调试事件需要智能体编辑者权限。 - [获取 WebRTC token](/docs/zh/api-reference/conversations/get-webrtc-token) - `GET /v1/convai/conversation/token` - 新增可选的 `debug_events_request`（布尔值，默认 `false`）。旧版 `GET /v1/convai/conversation/get_signed_url` 路由接受相同参数。 - [列出对话](/docs/zh/api-reference/conversations/list) - `GET /v1/convai/conversations` - 新增可选的 `triggered_procedure_ids`（可为 null 的字符串数组，最多 50 个），用于匹配运行过任一指定操作流程的对话。 - 新增可选的 `include_invalid_tool_calls`（布尔值，默认 `false`），以包含未运行的工具调用。 - 新增用于通话开始时间的可选 `sort_direction`（`asc` 或 `desc`，默认 `desc`）。 - [文本搜索对话消息](/docs/zh/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search` - 新增可选的 `triggered_procedure_ids`（可为 null 的字符串数组，最多 50 个）。 - 新增可选的 `include_invalid_tool_calls`（布尔值，默认 `false`）。 - [获取智能体对话主题](/docs/zh/api-reference/conversations/topics/get) - `GET /v1/convai/agents/{agent_id}/topics` - 新增可选的 `include_evaluation_criteria`（布尔值，默认 `true`）。 - `sort_by` 新增 `frustration`。 - 主题响应新增可为 null 的 `success_rate`（数字），整体响应新增 `aggregated_run_count`（整数，默认 `0`）。 - `from_unix_secs` 会向下取整至其 UTC 日期的起始时间。有界范围会聚合已完成的每日发现运行；省略两个边界则返回最新运行。 - [列出操作流程](/docs/zh/api-reference/agents/procedures/list)（`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures`）和 [获取操作流程](/docs/zh/api-reference/agents/procedures/get)（`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}`） - 新增可选且可为 null 的 `agent_version_id`（字符串），用于从特定智能体版本获取操作流程。 - [创建测试](/docs/zh/api-reference/tests/create) 和 [更新测试](/docs/zh/api-reference/tests/update) - 响应、模拟和工具调用单元测试 schema 新增可选且可为 null 的 `environment`（字符串）。该值用于选择特定环境的 URL、标头和身份验证连接；默认为 `production`。 - [创建 URL 文档](/docs/zh/api-reference/knowledge-base/create-from-url)、[创建爬取任务](/docs/zh/api-reference/knowledge-base/create-crawl-job) 和 [创建文件夹](/docs/zh/api-reference/knowledge-base/create-folder) - 自动同步新增可选且可为 null 的 `minimum_frequency_days`（整数，1–180）。默认值为 `7`，更严格的父文件夹频率优先。 ### 音乐 - [列出音乐 Finetune](/docs/zh/api-reference/music/finetunes/list) - `GET /v1/music/finetunes` - 最大 `page_size` 从 100 提高到 150。默认值仍为 50。 ## Schema 变更 ### ElevenAgents - 智能体更新请求新增可选且可为 null 的 `procedures`（`object`）。每个值都需要 `procedure_id` 和 `version_id`（字符串）。空对象会移除所有操作流程。 - 对话初始化配置新增 `enable_procedure_ids_from_client`（布尔值，默认 `false`）。初始化数据新增可选且可为 null 的 `procedure_ids`（字符串数组）；空数组会禁用起始智能体的所有操作流程。 - `ClientEvent` 新增 `context_usage`。 - 软超时覆盖新增可选且可为 null 的 `additional_soft_timeout_messages`（字符串数组）。 - 分析和 schema 覆盖模型中的常量值现在接受 `null`。 - 小组件配置中 `mic_muting_enabled` 和 `transcript_enabled` 的默认值已从 `false` 改为 `true`。请显式将其设为 `false` 以保留此前行为。 ### 工作区 - [获取用户](/docs/zh/api-reference/user/get) 响应已从 `UserResponseModel` 移除 `xi_api_key`。 - `ResourceMetadataResponseModel.role_to_group_ids` 现在接受自定义角色 ID 作为键，不再将键限制为 `admin`、`editor`、`commenter` 和 `viewer`。 - 直接发布响应新增可选且可为 null 的 `restricted_to_user_email_domains`（字符串数组）。 - 待处理订阅切换响应的 `next_tier` 新增 `go`。 ## August 22, 2026 ### MCP 服务器 - **本地 MCP 服务器已弃用**：本地 [ElevenLabs MCP 服务器](https://github.com/elevenlabs/elevenlabs-mcp)和 [MCP 播放器](https://github.com/elevenlabs/elevenlabs-mcp-player)已弃用，建议改用[托管 MCP 服务器](/docs/zh/eleven-agents/operate/hosted-mcp)。两个仓库均已归档，不再接收更新。托管服务器位于 `https://api.elevenlabs.io/v1/mcp`，可通过 OAuth 使用 ElevenLabs 账户登录，无需本地安装或 API 密钥。有关 Claude、Cursor 和其他 MCP 客户端的设置说明，请参阅[托管 MCP 服务器文档](/docs/zh/eleven-agents/operate/hosted-mcp)。 ## August 17, 2026 ### 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 ## 新增端点 ### 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` ## August 10, 2026 import { YoutubeEmbed } from "../../../components/YoutubeEmbed"; ### 配音 v2 API 现可通过 API 使用配音 v2。它可将音频和视频翻译成超过 90 种语言，同时保留每位说话者的音色、语气和节奏。 新的基于项目的 API 将源转录和翻译内容保留为可编辑的 JSON。通过文件或 URL 创建项目，添加一种或多种目标语言，编辑单个转录片段或翻译内容，然后仅重新生成发生变化的区域。按照[配音快速入门](/docs/zh/eleven-api/guides/cookbooks/dubbing)创建你的第一个配音。 创建首个配音 v2 项目，并生成翻译后的音轨。 编辑源转录和翻译内容，然后重新生成变化区域。 浏览配音项目、语言和转录端点。 ### ElevenAgents - **对话护栏过滤器**：[列出对话](/docs/zh/api-reference/conversations/list)新增可选的 `guardrail_types`（`GuardrailType[]`）和 `custom_guardrail_names`（字符串数组）查询参数。现有对话层级现在还可通过可选的 `parent_conversation_id`（字符串）进行过滤。 - **分支差异状态**：[列出智能体分支](/docs/zh/api-reference/agents/branches/list)新增可选的 `include_commit_status`（布尔值，默认 `false`）。启用后，分支摘要会包含可为空的 `commits_ahead`、`commits_behind` 和 `merged_into_branch_id` 字段。 - **对话和工具控制**：客户端覆盖现在支持 `max_duration_seconds` 和 `pronunciation_dictionary_locators`。MCP 服务器配置新增 `request_meta`，用于向工具调用传递 MCP `_meta` 值；Webhook 工具超时时间现最高支持 300 秒。 - **通话后分析用量**：对话计费新增 `analysis` 明细，其中包含按功能统计的累计总量和运行快照。转录消息新增 `triggered_guardrails`，对话轮次新增可选的 `producing_llm`。 ### 音色 - **音色搜索过滤器**：[获取全部音色 v2](/docs/zh/api-reference/voices/search)新增可选的 `gender`、`age`、`language`、`accent`、`use_cases`、`min_notice_period_days`、`include_custom_rates`、`include_live_moderated` 和 `high_quality` 查询参数。 ### SDK 发布 #### JavaScript SDK - [v2.63.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.63.0) - 新增实时语音转文本选项，支持次要语言、语言和实体检测、背景音频过滤、日志记录及一次性令牌认证。新增最终转录、实体和无效请求事件；修复未接受条款分发、重复的 `audio_format` 参数以及包容性 VAD 边界问题。 - [v2.62.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.62.0) - 新增配音批量转录更新方法和 `DubbingRegenerateResponse`；新增对话护栏过滤器、智能体分支提交状态、智能体告警和 MCP `requestMeta` 支持。创建语言目标不再接受 `modelId`。 - [v2.61.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.61.0) - 新增对话层级过滤、通话后分析计费、触发的护栏元数据、分支合并冲突详情、DTMF 输入脱敏和配音转录上传。移除导出的 OpenAI 实时会话类型和 `run_subagent_*` 工具结果变体。 #### Python SDK - [v2.63.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.63.0) - 新增实时语音转文本选项，支持次要语言、语言和实体检测、背景音频过滤、日志记录及一次性令牌认证。新增最终转录、实体和无效请求事件；修复未接受条款分发问题，并且现在会拒绝没有 API 密钥或令牌的连接。 - [v2.62.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.62.0) - 新增配音 `update_segments` 方法和 `DubbingRegenerateResponse`；新增 `guardrail_types`、`custom_guardrail_names`、`include_commit_status` 和 MCP `request_meta` 支持。配音片段更新现在使用请求正文模型，创建语言目标不再接受 `model_id`。 - [v2.61.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.61.0) - 新增 `parent_conversation_id`、分析计费、触发的护栏元数据、分支合并冲突、DTMF 输入脱敏和配音转录上传。移除 OpenAI 实时会话类型和 `run_subagent_*` 结果模型。 #### Android SDK - [v0.12.1](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.12.1) - 修复有意断开纯文本会话时被报告为 `ConversationStatus.ERROR` 的问题。 - [v0.12.0](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.12.0) - 新增 `ConversationConfig.useMediaStream`，用于通过 Android 媒体流路由对话音频。远程正常关闭 WebSocket 现在会报告 `DisconnectionDetails.Agent`，本地发起的关闭则报告 `DisconnectionDetails.User`。 #### MCP 服务器 - [v0.12.2](https://github.com/elevenlabs/elevenlabs-mcp/releases/tag/v0.12.2) - 修复路径遍历问题。 ### API ## 新增端点 ### 配音 - [批量更新源片段](/docs/zh/api-reference/dubbing/source-transcript/batch-update-source-segments) - `PATCH /v1/dubbing/project/{project_id}/transcript/segments` - 需要 `DubbingBulkSegmentUpdateRequest` - 以原子方式更新源片段文本、说话者或时间信息 - 返回包含已更新 `segments` 和 `revision` 的 `DubbingBulkSourceSegmentUpdateResponse` - [批量更新目标片段](/docs/zh/api-reference/dubbing/target-transcript/batch-update-target-segments) - `PATCH /v1/dubbing/project/{project_id}/language/{language_id}/transcript/segments` - 需要 `DubbingBulkTargetSegmentUpdateRequest` - 以原子方式更新多个目标片段的翻译内容 - 返回包含已更新 `segments` 和 `revision` 的 `DubbingBulkTargetSegmentUpdateResponse` ## 已更新端点 ### ElevenAgents - [列出对话](/docs/zh/api-reference/conversations/list) - `GET /v1/convai/conversations` - 新增可选的 `parent_conversation_id`（字符串） - 新增可选的可重复 `guardrail_types`（`GuardrailType[]`）和 `custom_guardrail_names`（字符串数组） - [列出智能体分支](/docs/zh/api-reference/agents/branches/list) - `GET /v1/convai/agents/{agent_id}/branches` - 新增可选的 `include_commit_status`（布尔值，默认 `false`） - 分支摘要新增可为空的 `commits_ahead`（整数）、`commits_behind`（整数）和 `merged_into_branch_id`（字符串） ### 音色 - [获取全部音色 v2](/docs/zh/api-reference/voices/search) - `GET /v2/voices` - 新增可选的 `gender`、`age` 和 `accent`（字符串）过滤器 - 新增可选的 `language` 和 `use_cases`（字符串数组）过滤器 - 新增可选的 `min_notice_period_days`（整数）、`include_custom_rates`、`include_live_moderated` 和 `high_quality`（布尔值）过滤器 ## 架构变更 ### ElevenAgents - 客户端覆盖架构新增 `max_duration_seconds`（整数）和 `pronunciation_dictionary_locators`（数组） - MCP 服务器输入和输出架构新增 `request_meta` 映射 - 智能体平台设置新增 `alerting`；语言检测新增 `only_at_conversation_start`（布尔值） - `AnalysisCharging.last_run` 现在为必填且不可为空；累计总量新增必填的 `runs`（整数） - RAG 块响应现在要求包含 `content_format` 和 `document_type` ## August 3, 2026 ### ElevenAgents - **测试专用工具模拟**：智能体模拟和单元测试现在可定义以工具 ID 为键的 `tool_mock_overrides`，以替换单项测试的共享模拟。`ToolResponseMockConfig` 还新增可选的 `is_error`（布尔值，默认 `false`），让模拟可以测试工具失败路径。 - **已翻译的 workflow 消息**：字面量 Say 节点消息新增 `text_translations`，这是从语言键到 `TranslatedString` 对象的映射。该字段在输入中可选、在输出中必填，因此严格的响应验证器必须接受它。 - **对话版本筛选**：[列出对话](/docs/zh/api-reference/conversations/list)和[文本搜索对话消息](/docs/zh/api-reference/conversations/messages/text-search)新增可选的 `version_id` 查询参数（字符串），用于按智能体版本筛选结果。 - **知识库系统工具**：智能体配置新增 `knowledge_base` 系统工具，其中可配置 `enabled_strategies`（`SearchStrategy[]`）。智能体知识库 RAG 查询新增可选的 `use_agent_defaults`（布尔值，默认 `true`）；将其设为 `false` 可使用中性检索设置，同时保留智能体的嵌入模型。 - **智能体语音活动检测**：智能体创建、更新、响应和 workflow 覆盖架构新增 `vad` 配置。`VADConfig` 目前支持 `background_voice_detection`（布尔值，默认 `false`）。 - **WebSocket 自定义 LLM**：`CustomLLMAPIType` 新增 `websocket`。 - **文件内存控制**：小组件文件输入配置新增 `max_files_in_memory`（整数，1–30，默认 `10`）。超过限制的文件会被摘要化并从内存中释放；`max_files_per_conversation` 必须为 `-1` 或至少等于内存限制。 - **DTMF 输入脱敏**：`DTMFInputConfig` 新增可选的 `redact_input`（布尔值，默认 `false`），用于替换转写文本、对话日志和分析中的来电者键盘数字。智能体重复的数字或传给工具的数字保持不变。 ### 语音转文本 - **实时实体检测**：Scribe v2 Realtime 新增 `entity_detection` 查询选项。它接受 `all`、单个实体类型或类别，或类型和类别数组，并在 `committed_transcript_entities` 事件中输出检测到的实体。支持的类别请参阅[实体检测指南](/docs/zh/eleven-api/guides/how-to/speech-to-text/batch/entity-detection)。 ### 音色 - **跨数据驻留地复制音色**：新增 `POST /v1/voices/{voice_id}/replicate-to-isolated-environment`，用于将即时语音克隆或声音设计音色复制到同一合并计费组中的工作区。请求需要 `target_workspace_id`（字符串），并接受 `preserve_voice_id`（布尔值，默认 `true`）；响应返回目标 `voice_id`。 - **角色元数据**：角色响应新增 `recommended_voice_ids`（字符串数组，默认 `[]`），元数据新增可为 null 的 `role`（`CharacterRole`），并且 `CharacterAge` 将 `middle-aged` 替换为 `middle_aged`。 ### SDK 发布 #### 软件包 - [@elevenlabs/client@1.16.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.16.0)、[@elevenlabs/react@1.11.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.11.0)、[@elevenlabs/types@0.18.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.18.0)、[@elevenlabs/react-native@1.2.17](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.17) 和 [@elevenlabs/convai-widget-core@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.15.0) - 新增 `onAgentReasoningResponsePart`，用于接收类型为 `start`、`delta` 和 `stop` 的流式智能体推理事件。 - [@elevenlabs/convai-widget-core@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.15.0) 和 [@elevenlabs/convai-widget-embed@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.15.0) - 新增 `show_resize_button` 和 `show-resize-button` 嵌入属性。将其中任一项设为 `false`，即可隐藏小组件标题栏的展开和收起控件。 - [@elevenlabs/client@1.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.17.0)、[@elevenlabs/react@1.12.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.0)、[@elevenlabs/types@0.19.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.19.0)、[@elevenlabs/react-native@1.2.18](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.18) 和 [@elevenlabs/convai-widget-core@0.15.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.15.1) - 为 `Scribe.connect` 和 `useScribe` 新增 `enableLogging` 选项。将其设为 `false` 会启动企业版零保留会话。Scribe 的 `session_started` 类型现在会报告 `enable_logging`；已移除未使用的 `disable_logging` 字段。 #### MCP 服务器 - [v0.12.1](https://github.com/elevenlabs/elevenlabs-mcp/releases/tag/v0.12.1) - 包含 v0.11 工具更新和依赖项刷新，解决了 44 个安全警报。 - [v0.11.0](https://github.com/elevenlabs/elevenlabs-mcp/releases/tag/v0.11.0) - 新增 `simulate_conversation`，支持配置模拟用户行为、评估标准、转写输出和通过/失败分析。`speech_to_text` 工具现在默认使用 `scribe_v2`，`voice_clone` 现在发送音频文件内容而非路径字符串。 ### API ## 新增端点 ### 音色 - `POST /v1/voices/{voice_id}/replicate-to-isolated-environment` - 将即时语音克隆或声音设计音色复制到其他工作区的隔离环境 - 需要 `target_workspace_id`（字符串） - 接受可选的 `preserve_voice_id`（布尔值，默认 `true`） - 返回必填的 `voice_id`（字符串） ## 已更新端点 ### ElevenAgents - [列出对话](/docs/zh/api-reference/conversations/list) - `GET /v1/convai/conversations` - 新增可选的 `version_id`（字符串）查询参数 - [文本搜索对话消息](/docs/zh/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search` - 新增可选的 `version_id`（字符串）查询参数 - `POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query` - 新增可选的 `use_agent_defaults`（布尔值，默认 `true`）请求字段 ## 架构变更 ### ElevenAgents - 模拟和单元测试负载新增可选的 `tool_mock_overrides` 映射；`ToolResponseMockConfig` 新增可选的 `is_error`（布尔值，默认 `false`） - `SayNodeLiteralMessage` 新增 `text_translations`（`TranslatedString` 映射）；该字段在输入中可选、在输出中必填 - 智能体配置新增 `knowledge_base`（`KnowledgeBaseToolConfig`）和 `vad`（`VADConfig`） - `CustomLLMAPIType` 新增 `websocket` - `FileInputConfig` 新增 `max_files_in_memory`（整数，1–30，默认 `10`） - `DTMFInputConfig` 新增可选的 `redact_input`（布尔值，默认 `false`） - 实时智能体配置现在默认使用 `eleven_realtime_v1_mini` ### 音色 - 角色响应新增 `recommended_voice_ids`（字符串数组，默认 `[]`） - 角色元数据新增可为 null 的 `role`（`CharacterRole`） - 破坏性变更：`CharacterAge` 将 `middle-aged` 替换为 `middle_aged`；发送旧值的客户端必须迁移 ### 文本转语音 - 破坏性变更：已从 ElevenAgents 文本转语音配置架构中移除 `AudioFilterId` 和 `audio_filter` ## July 27, 2026 ### ElevenAgents - **WhatsApp 分支和环境覆盖**：[Outbound WhatsApp messages](/docs/zh/api-reference/whats-app/outbound-message) 和 [outbound calls](/docs/zh/api-reference/whats-app/outbound-call) 现在会遵循 `conversation_initiation_client_data` 中传入的 `branch_id` 和 `environment`。所有消息发送前都会验证覆盖项——未知分支或环境会报错拒绝——并且会在整个对话期间持续生效，因此客户回复后会在指定的 [分支](/docs/zh/eleven-agents/operate/versioning) 和 [环境](/docs/zh/eleven-agents/integrate/environment-variables) 中继续对话。示例请参阅 [WhatsApp 指南](/docs/zh/eleven-agents/whatsapp)。 - **流程 API**：新增 8 项面向公众、限定分支范围的操作，用于管理[流程](/docs/zh/eleven-agents/customization/procedures)。你可以创建、列出、获取和删除流程；创建、获取或丢弃草稿更改；以及将流程草稿编译为智能体 workflow。创建流程时可传入 `name`、`content`、`type` 和 `trigger`。空 `trigger` 会创建子流程；省略 `trigger` 或将其设为 `null` 时，会根据流程内容推导触发条件。 - **知识库爬取任务**：新增用于创建、列出、查看和取消爬取任务的 API。创建请求需要 `url`（字符串），并支持爬取深度、页面数量限制、URL 模式、站点地图 URL、文件夹放置位置、自动同步和移除不可用文档。 - **知识库批量管理**：新增针对 1–20 个唯一文档或文件夹 ID 的[批量依赖项检查](/docs/zh/api-reference/knowledge-base/dependent-agents-multiple)和[批量删除](/docs/zh/api-reference/knowledge-base/bulk-delete)。依赖项检查支持分页和 `dependent_type`；删除操作会为每个 ID 分别返回成功或失败结果。设置 `force: true` 还会移除依赖项，并递归删除非空文件夹。 - **批量通话结果导出**：新增[导出批量通话结果](/docs/zh/api-reference/batch-calling/export)，可将已结束批次的收件人和对话结果下载为 CSV。 - **对话筛选和分析数据**：[列出对话](/docs/zh/api-reference/conversations/list)和[文本搜索对话消息](/docs/zh/api-reference/conversations/messages/text-search)新增可选的 `visited_agent_ids` 和 `visited_agent_branch_ids` 数组筛选条件，每项最多包含 50 个值。列出请求还接受 `data_collection_ids` 和 `evaluation_criteria_ids`，以在每个对话摘要中包含对应结果。摘要新增可选的 `data_collection_results`、`evaluation_criteria_results` 和 `tag_ids`。 - **引用式分析配置**：智能体平台设置新增可选且可为 null 的 `analysis_items` 字段，类型为 `AgentAnalysisItems`，用于通过引用关联评估和数据收集项。值为 `null` 表示智能体仍使用旧版内联字段；空值表示已迁移的智能体未关联任何项目。 - **流程依赖项元数据**：流程引用新增 `trigger`（字符串），以及 `referenced_tool_ids`、`referenced_kb_ids`、`referenced_procedure_ids` 和 `referenced_dynamic_variables` 数组。 - **WebRTC 令牌响应**：[获取 WebRTC 令牌](/docs/zh/api-reference/conversations/get-webrtc-token)响应除 `token` 外，现在还必须包含 `conversation_id`（字符串）。对于验证或反序列化响应结构的客户端，这是一次破坏性架构变更。 - **知识库 RAG 结果**：`KnowledgeBaseRagToolResultModel` 新增 `chunks`（`KnowledgeBaseRagChunkModel[]`），用于工具结果中的 RAG 结果模式。 ### Studio - **项目草稿状态**：`ProjectCreationMetaResponseModel.status` 新增 `draft`。项目创建类型现在使用共享的 `ProjectCreationMetaType` 枚举，现有值保持不变。 ### 音色 - **音色口音**：新增 `GET /v1/voices/accents`，用于列出共享声音库中可用的口音。结果可按 `language` 和 `model_id` 筛选，每种口音都会返回 `accent`、`language`、`code` 和人类可读的 `name`。可将 `accent` 值传给[获取共享音色](/docs/zh/api-reference/voices/voice-library/get-shared)的 `accent` 查询参数，以筛选共享音色。 ### 工作区 - **Webhook 用量报告**：`WebhookUsageType` 新增 `Flows`。 ### SDK 发布 #### JavaScript SDK - [v2.60.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.60.0) - 新增 `voices.accents.get`，用于列出共享声音库中的音色口音；还新增了最新架构中的 ElevenAgents 流程、知识库爬取任务、批量管理 API 和引用式分析配置。 #### Python SDK - [v2.60.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.60.0) - 新增最新架构中的音色口音、ElevenAgents 流程、知识库爬取任务和批量管理 API。同时修复了 `AsyncConversation` 启动时的阻塞问题，并修正了基本类型列表 multipart 字段的发送方式，使其作为重复表单字段发送。 #### 软件包 - [@elevenlabs/client@1.15.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.15.2) - 修复 WebRTC 传输上的 `onAudioAlignment`：从音频消息转发对齐元数据，同时仍通过 LiveKit 轨道播放音频。 - [@elevenlabs/react@1.10.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.10.2)、[@elevenlabs/react-native@1.2.16](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.16)、[@elevenlabs/convai-widget-core@0.14.12](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.12) 和 [@elevenlabs/convai-widget-embed@0.14.12](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.12) - 更新依赖项，包含来自 `@elevenlabs/client@1.15.2` 的 WebRTC 对齐修复。 ### API ## 新增端点 ### ElevenAgents - `POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures` - 创建流程并返回其 `procedure_id`（字符串） - 接受可选的 `name`（字符串，最多 200 个字符）、`content`（字符串）、`type`（`ProcedureType`，默认 `free_form`）和 `trigger`（可为 null 的字符串） - `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures` - 列出分支流程，包含 `procedure_id`、`version_id`、`name`、`type`、`trigger` 和 `has_draft` - 不包含流程内容；请获取单个流程以读取其内容 - `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}` - 接受可选的 `version_id`（字符串）；否则返回分支头部的版本 - 返回 `name`、`content`、`type` 和 `trigger` - `DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}` - 从分支的草稿工作集中移除流程 - `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft` - 返回当前流程草稿 - `PATCH /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft` - 创建或更新草稿 - 需要 `name`（字符串，最多 200 个字符）、`content`（字符串，最多 50,000 个字符）和 `type`（`ProcedureType`）；接受可选的 `trigger`（可为 null 的字符串） - `DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft` - 丢弃草稿更改，并将流程重置为已提交版本 - `POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/compile` - 将流程草稿编译为 `AgentWorkflowResponseModel` - [创建爬取任务](/docs/zh/api-reference/knowledge-base/create-crawl-job) - `POST /v1/convai/knowledge-base/crawl` - 需要 `url`（字符串） - 接受可选的 `max_depth`（整数，1–5，默认 `3`）、`max_pages`（整数，1–10,000，默认 `1000`）、`pattern`（字符串）、`sitemap_urls`（字符串数组）、`parent_folder_id`（字符串）、`enable_auto_sync`（布尔值，默认 `false`）和 `auto_remove`（布尔值，默认 `false`） - [列出爬取任务](/docs/zh/api-reference/knowledge-base/list-crawl-jobs) - `GET /v1/convai/knowledge-base/crawl` - 接受可选的 `include_job_ids`（字符串数组）、`page_size`（整数，1–100，默认 `30`）和 `cursor`（字符串） - [获取爬取任务](/docs/zh/api-reference/knowledge-base/get-crawl-job) - `GET /v1/convai/knowledge-base/crawl/{crawl_job_id}` - [取消爬取任务](/docs/zh/api-reference/knowledge-base/cancel-crawl-job) - `POST /v1/convai/knowledge-base/crawl/{crawl_job_id}/cancel` - [获取多个文档的依赖智能体](/docs/zh/api-reference/knowledge-base/dependent-agents-multiple) - `POST /v1/convai/knowledge-base/dependent-agents` - 需要 `document_ids`（包含 1–20 个唯一字符串的数组） - 接受可选的 `dependent_type`（`KnowledgeBaseDependentType`，默认 `all`）、`page_size`（整数，1–100，默认 `30`）和 `cursor`（字符串） - [批量删除知识库文档](/docs/zh/api-reference/knowledge-base/bulk-delete) - `POST /v1/convai/knowledge-base/bulk-delete` - 需要 `document_ids`（包含 1–20 个唯一字符串的数组） - 接受可选的 `force`（布尔值，默认 `false`） - 为每个文档 ID 返回成功或失败结果 - [导出批量通话结果](/docs/zh/api-reference/batch-calling/export) - `GET /v1/convai/batch-calling/{batch_id}/export` - 将已结束批次的收件人和对话结果作为 CSV 返回 ### 音色 - `GET /v1/voices/accents` - 列出共享声音库中可用的口音 - 接受可选的 `language`（字符串）和 `model_id`（字符串）查询参数 - 每种口音返回 `accent`、`language`、`code` 和 `name` ## 已更新端点 ### ElevenAgents - [列出对话](/docs/zh/api-reference/conversations/list) - `GET /v1/convai/conversations` - 新增可选的 `visited_agent_ids` 和 `visited_agent_branch_ids` 字符串数组筛选条件，每项最多包含 50 个值 - 新增可选的 `data_collection_ids` 和 `evaluation_criteria_ids` 字符串数组，用于选择每个摘要的分析结果 - 响应摘要新增可选对象字段 `data_collection_results` 和 `evaluation_criteria_results`，以及字符串数组 `tag_ids` - [文本搜索对话消息](/docs/zh/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search` - 新增可选的 `visited_agent_ids` 和 `visited_agent_branch_ids` 字符串数组筛选条件，每项最多包含 50 个值 - [获取 WebRTC 令牌](/docs/zh/api-reference/conversations/get-webrtc-token) - `GET /v1/convai/conversation/token` - 响应现在必须包含 `conversation_id`（字符串） - 破坏性变更：严格的响应验证器和反序列化器必须接受新的必填字段 ## 架构变更 ### ElevenAgents - 智能体平台请求和响应设置新增可选且可为 null 的 `analysis_items` 字段，类型为 `AgentAnalysisItems`，用于引用式评估和数据收集配置 - 流程引用新增 `trigger`（字符串）、`referenced_tool_ids`（字符串数组）、`referenced_kb_ids`（字符串数组）、`referenced_procedure_ids`（字符串数组）和 `referenced_dynamic_variables`（字符串数组） - `KnowledgeBaseRagToolResultModel` 新增 `chunks`（`KnowledgeBaseRagChunkModel[]`） ### Studio - `ProjectCreationMetaResponseModel.status` 新增 `draft` - `ProjectCreationMetaResponseModel.type` 现在引用共享的 `ProjectCreationMetaType` 枚举 ### 工作区 - `WebhookUsageType` 新增 `Flows` ## July 20, 2026 ### 音乐 - **Music Finetunes API**：新增用于管理 [Music Finetunes](/docs/zh/eleven-creative/products/music/finetunes) 的 API 支持。5 个端点可让你通过上传的音频创建 Finetune、列出可访问的 Finetune、获取训练状态、更新元数据和可见性，或删除 Finetune。现在所有音乐生成 SDK 方法都提供 `finetune_id`。 ### ElevenAgents - **解析外部对话引用**：新增 `GET /v1/convai/conversations/resolve`，可将 Slack 消息 URL 或 Zendesk 工单 URL 解析为对话。请求需要 `agent_id` 和 `reference` 查询参数（字符串）。 - **查询智能体知识库**：新增 `POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query`，用于对智能体知识库执行只读 RAG 查询。请求需要 `query`（字符串），接受可选 `branch_id`（字符串），并返回按排名排列的分块及文档、分块、文本和向量距离元数据。此端点不包含在生成的 SDK 中。 - **知识库内容格式**：知识库文件、文本和 URL 响应新增可选 `content_format`（`html` | `markdown`，默认 `html`）。 - **智能体语音配置**：TTS 覆盖架构新增可由客户端覆盖的可选 `model_id`（`TTSConversationalModel`）。`enable_phoneme_tags` 默认值从 `false` 改为 `true`。 - **更快的备用 LLM 级联**：默认 `cascade_timeout_seconds` 从 8 秒改为 4 秒。允许范围仍为 2–15 秒。 - **工具参数值来源**：对象工具参数现在可使用 `dynamic_variable`、`constant_value` 或 `is_omitted`，与现有标量和数组控件保持一致。常量架构覆盖现在支持任意数组和对象。 - **完整响应护栏**：自定义护栏新增可选 `evaluate_full_response_only`（布尔值，默认 `false`），用于仅对完整的非 TTS 响应评估一次。此选项需要阻止模式。 - **Twilio 通话录音**：电话通信通话配置新增可选 `twilio_call_recording_enabled`（布尔值，默认 `false`）。录音存储在已连接的 Twilio 账户中，其他提供商会忽略此设置。 - **小组件文件上传文本**：小组件文本配置新增可选标签和错误消息，用于附加和移除文件、上传失败、不支持的类型、超大文件、文件数量限制及输入指示器。 - **知识库同步状态**：知识库文件响应新增可选 `auto_sync_info` 和 `refresh_status`（`FileRefreshStatus`）。文件夹响应新增必填 `document_count`（整数），即非文件夹文档的递归计数，上限为 1000。 - **对话文本搜索筛选条件**：[文本搜索对话消息](/docs/zh/api-reference/conversations/messages/text-search) 新增可选 `exclude_statuses` 和 `termination_reasons` 数组查询参数。 - **LLM 选项**：智能体 LLM 配置新增 `gpt-5.6-sol`、`gpt-5.6-terra` 和 `gpt-5.6-luna`。`LLMReasoningEffort` 新增 `max`。 - **WhatsApp 输入指示器**：WhatsApp 账户请求和响应架构新增可选 `enable_typing_indicator`（布尔值）。 ### 语音转文本 - **单次批处理身份验证**：[将语音转换为文本](/docs/zh/api-reference/speech-to-text/convert) 新增可选 `token`（字符串），可替代 API 密钥或 Bearer 身份验证。使用 `POST /v1/single-use-token/batch_scribe` 创建单次令牌；其将在 15 分钟后过期。 - **实时客户端可靠性**：`@elevenlabs/client` 现在会通过 `RealtimeEvents.ERROR` 报告麦克风设置和服务器格式错误，设置失败和连接关闭后会释放麦克风资源，并在套接字拆除后丢弃延迟到达的麦克风帧。 ### 文本转语音 - **已归档发音词典**：[列出发音词典](/docs/zh/api-reference/pronunciation-dictionaries/list) 新增可选 `include_archived`（布尔值，默认 `true`）。 ### 工作区 - **Webhook 事件订阅**：[更新工作区 Webhook](/docs/zh/api-reference/webhooks/update) 请求新增可选 `events`（`WorkspaceWebhookEventType[]`），包含 `voice_library_removal_notice`、`speech_to_text` 和 `agent_qa`。Webhook 响应可返回已订阅的事件列表。 - **用量分析维度**：[获取工作区用量](/docs/zh/api-reference/analytics/workspace/usage) 在 `group_by` 值中新增 `surface` 和 `actor`。 - **清除服务账户限制**：[更新服务账户 API 密钥](/docs/zh/api-reference/service-accounts/api-keys/update) 接受 `character_limit: "clear"`，可移除每月字符限制，此外还支持 `"no_update"` 和整数值。 - **告警 Webhook 引用**：告警 Webhook 通知程序架构现在使用必填 `webhook_id`（字符串）标识工作区 Webhook，而非嵌入 `url`、`method` 和 `headers`。 ### SDK 发布 #### JavaScript SDK - [v2.59.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.59.0) - 新增 `music.finetunes` 方法，可列出、创建、获取、更新和删除 Music Finetunes。还新增了对话引用解析、已归档发音词典筛选和单次 Speech to Text 令牌。 #### Python SDK - [v2.59.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.59.0) - 根据最新 API 架构新增 Music Finetunes 和对话引用解析。`OnPremInitiationData` 还新增类型化的 `post_call_transcription_webhook` 和 `post_call_audio_webhook` 配置，并提供可选 `hmac_secret`，用于签名通话后 Webhook。 #### 软件包 - [@elevenlabs/client@1.15.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.15.1) - 改进了 Scribe Realtime 在设置失败、客户端或服务器关闭以及延迟音频帧期间的错误传递和麦克风清理。 - [@elevenlabs/react@1.10.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.10.1)、[@elevenlabs/react-native@1.2.15](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.15)、[@elevenlabs/convai-widget-core@0.14.11](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.11) 和 [@elevenlabs/convai-widget-embed@0.14.11](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.11) - 更新依赖项，以包含 `@elevenlabs/client@1.15.1` 的 Scribe Realtime 修复。 #### Android SDK - [v0.11.1](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.11.1) - 防止 R8 和 ProGuard 混淆传出 WebSocket 和 WebRTC 事件字段，如 `text` 和 `type`。 #### CLI - [@elevenlabs/cli@0.5.6](https://github.com/elevenlabs/cli/releases/tag/%40elevenlabs%2Fcli%400.5.6) - 更新默认智能体模板，使用 `scribe_realtime` 替代已移除的 `elevenlabs` ASR 提供商。精简模板仍使用服务器默认设置。 ### API ## 新增端点 ### 音乐 - [列出 Music Finetunes](/docs/zh/api-reference/music/finetunes/list) - `GET /v1/music/finetunes` - 支持游标分页、可见性和创建者筛选，以及按创建时间或名称排序 - [创建 Music Finetune](/docs/zh/api-reference/music/finetunes/create) - `POST /v1/music/finetunes` - 需要 `name` 和 `primary_genre` - 最多接受 50 个音频文件、标签、可见性和 `model_id` - [获取 Music Finetune](/docs/zh/api-reference/music/finetunes/get) - `GET /v1/music/finetunes/{finetune_id}` - [更新 Music Finetune](/docs/zh/api-reference/music/finetunes/update) - `PATCH /v1/music/finetunes/{finetune_id}` - 更新 `name`、`tags`、`primary_genre` 或 `visibility` - [删除 Music Finetune](/docs/zh/api-reference/music/finetunes/delete) - `DELETE /v1/music/finetunes/{finetune_id}` ### ElevenAgents - `GET /v1/convai/conversations/resolve` - 需要 `agent_id`（字符串）和 `reference`（字符串）查询参数 - 返回 `GetConversationResponseModel` - `POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query` - 请求正文需要 `query`（字符串） - 接受可选 `branch_id`（字符串）查询参数 - 返回 `AgentKnowledgeBaseRagQueryResponseModel` - 不包含在生成的 SDK 中 ## 更新的端点 ### ElevenAgents - [文本搜索对话消息](/docs/zh/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search` - 新增可选 `exclude_statuses` 和 `termination_reasons` 数组查询参数 ### 语音转文本 - [将语音转换为文本](/docs/zh/api-reference/speech-to-text/convert) - `POST /v1/speech-to-text` - 新增可选 `token`（字符串）查询参数，用于单次批处理 Scribe 令牌 ### 文本转语音 - [列出发音词典](/docs/zh/api-reference/pronunciation-dictionaries/list) - `GET /v1/pronunciation-dictionaries` - 新增可选 `include_archived`（布尔值，默认 `true`）查询参数 ### 工作区 - [更新工作区 Webhook](/docs/zh/api-reference/webhooks/update) - `PATCH /v1/workspace/webhooks/{webhook_id}` - 新增可选 `events`（`WorkspaceWebhookEventType[]`）请求字段 - [获取工作区用量](/docs/zh/api-reference/analytics/workspace/usage) - `POST /v1/workspace/analytics/query/usage-by-product-over-time` - 可选 `group_by` 数组新增 `surface` 和 `actor` - [更新服务账户 API 密钥](/docs/zh/api-reference/service-accounts/api-keys/update) - `PATCH /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id}` - 可选 `character_limit` 字段新增 `"clear"` ## 架构变更 ### ElevenAgents - ElevenAgents 知识库响应架构新增可选 `content_format`（`html` | `markdown`，默认 `html`） - 知识库文件响应新增可选 `auto_sync_info` 和 `refresh_status`（`FileRefreshStatus`） - 知识库文件夹响应新增必填 `document_count`（整数） - 智能体 TTS 覆盖架构新增可选 `model_id`（`TTSConversationalModel`） - 智能体 TTS `enable_phoneme_tags` 的默认值现为 `true`，而非 `false` - 备用 LLM `cascade_timeout_seconds` 的默认值现为 4 秒，而非 8 秒 - 智能体 LLM 配置新增 `gpt-5.6-sol`、`gpt-5.6-terra` 和 `gpt-5.6-luna`；`LLMReasoningEffort` 新增 `max` - 自定义护栏新增可选 `evaluate_full_response_only`（布尔值，默认 `false`） - 电话通信通话配置新增可选 `twilio_call_recording_enabled`（布尔值，默认 `false`） - 对象工具参数新增 `dynamic_variable`、`constant_value` 和 `is_omitted`；常量覆盖支持任意数组和对象值 - 小组件文本配置新增可选文件上传和输入指示器标签 - WhatsApp 账户架构新增可选 `enable_typing_indicator`（布尔值） - 模拟和测试架构新增 `AutoGenerationMetadata` 和 `SimulationLibrarySettings` ### 音乐 - 新增 Music Finetune 请求、响应、分页、可见性、创建者、状态和失败原因架构 - 所有音乐生成请求架构均向生成的 SDK 提供 `finetune_id` ### 工作区 - 工作区 Webhook 请求和响应架构新增可选 `events`（`WorkspaceWebhookEventType[]`） - 告警 Webhook 通知程序架构使用必填 `webhook_id`（字符串），替代 `url`、`method` 和 `headers` ## July 13, 2026 ### ElevenAgents - **按智能体进行情感分析**：平台设置新增可选的 `sentiment_analysis`（`SentimentAnalysisSettings`），用于配置各智能体通话后的情感评分。 - **自动翻译转录文本**：平台设置新增可选的 `auto_translate_transcript_to_app_language`（布尔值），可在历史记录中将对话转录文本翻译为查看者的应用语言。 - **嵌套智能体转接**：工作流新增 push、pop 和 replace 操作，支持嵌套智能体转接。 - **附和语检测**：转录文本的用户轮次模型新增可选 `ignored_as_backchannel`（布尔值），用于标记被过滤为附和语的语句。 - **辅助对话音频**：[获取对话](/docs/zh/api-reference/conversations/get)响应新增必填的 `has_auxiliary_audio`（布尔值），与现有音频标志一同返回。 - **MCP 环境范围限定**：MCP 服务器和工具路由在列出工具、获取工具、创建工具配置及更新工具配置端点中，新增可选 `environment` 查询参数（默认为 production）。 - **工具调用音效覆盖**：工具和 MCP 覆盖架构支持 `tool_call_sound: "off"`，可静音单个工具的调用音效；未设置时继承服务器默认值。 - **Twilio SMS 路由**：Twilio 电话号码导入请求新增可选 `enable_sms`（布尔值，默认开启），用于在号码设置期间控制入站 SMS 路由。 - **用户情感排序**：[列出用户](/docs/zh/api-reference/users/list)新增可选 `sort_direction`，并支持按 `average_sentiment_score` 排序。 - **知识库外部同步**：外部同步架构将 `ExternalSyncType` 重命名为 `ExternalSyncProvider`，新增使用 `KbExternalSyncJob` 的同步任务触发器和类型枚举；文件夹响应可包含 `active_sync_job`，显示进行中或已结束的同步状态。 - **TTS 延迟设置弃用**：智能体 TTS 设置中的 `optimize_streaming_latency` 已标记为弃用，并注明其无实际作用。 ### 工作区 - **创建服务账号**：新增[创建服务账号](/docs/zh/api-reference/service-accounts/create)（`POST /v1/service-accounts`），支持可选 `default_sharing_groups`（`DefaultSharingGroupConfig`），可通过编程方式创建服务账号。 - **列出工作区成员**：新增[获取工作区成员](/docs/zh/api-reference/workspace/members/list)（`GET /v1/workspace/members`），返回包含用户 ID、邮箱、席位状态、所有者和锁定标志的 `WorkspaceMemberResponseModel` 条目。不包含服务账号。 - **邀请额度上限**：工作区邀请载荷（单个和批量）新增可选 `usage_limit`，用于限制受邀者每月额度上限。 ### SDK 发布 #### JavaScript SDK - [v2.57.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.57.0) - 根据最新 OpenAPI 架构重新生成，包含 `run_subagent` 系统工具类型、按智能体配置的情感分析设置、嵌套智能体转接工作流模型、知识库外部同步类型及 MCP `environment` 查询参数。 - [v2.58.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.58.0) - 根据最新 OpenAPI 架构重新生成，包含服务账号创建、工作区成员列表、邀请 `usage_limit`、对话 `has_auxiliary_audio` 以及多上下文文本转对话 WebSocket 消息类型。 #### Python SDK - [v2.57.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.57.0) - 根据最新 OpenAPI 架构重新生成，包含 `run_subagent` 系统工具模型、按智能体配置的情感分析设置、嵌套智能体转接工作流模型、知识库外部同步类型及 MCP `environment` 查询参数。 - [v2.58.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.58.0) - 根据最新 OpenAPI 架构重新生成，包含服务账号创建、工作区成员列表、邀请 `usage_limit`、对话 `has_auxiliary_audio` 以及多上下文文本转对话 WebSocket 消息类型。 #### 软件包 - [@elevenlabs/client@1.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.15.0) - 新增 `onPing` 回调，提供 `ping` 事件和预估的 `ping_ms`，用于监控连接延迟。 - [@elevenlabs/react@1.10.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.10.0) - 在 React hooks 中公开了来自 `@elevenlabs/client@1.15.0` 的 `onPing` 回调。 - [@elevenlabs/types@0.17.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.17.1)、[@elevenlabs/convai-widget-core@0.14.10](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.10) 和 [@elevenlabs/convai-widget-embed@0.14.10](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.10) - 与 `@elevenlabs/client@1.15.0` 对齐依赖项。 ### API ## 新增端点 ### 工作区 - [创建服务账号](/docs/zh/api-reference/service-accounts/create) - `POST /v1/service-accounts` - [获取工作区成员](/docs/zh/api-reference/workspace/members/list) - `GET /v1/workspace/members` ## 更新的端点 ### ElevenAgents - [获取对话](/docs/zh/api-reference/conversations/get) - `GET /v1/convai/conversations/{conversation_id}` - 响应新增必填 `has_auxiliary_audio`（布尔值） - [列出用户](/docs/zh/api-reference/users/list) - `GET /v1/convai/users` - 新增可选 `sort_direction` 查询参数 - 新增 `average_sentiment_score` 排序选项 - [获取工具](/docs/zh/api-reference/tools/get) - `GET /v1/convai/tools/{tool_id}` - 新增可选 `environment` 查询参数 - [列出 MCP 服务器工具](/docs/zh/api-reference/mcp/list-tools) - `GET /v1/convai/mcp-servers/{mcp_server_id}/tools` - 新增可选 `environment` 查询参数 - [创建 MCP 工具配置](/docs/zh/api-reference/mcp/tool-configuration/create) - `POST /v1/convai/mcp-servers/{mcp_server_id}/tool-configs` - 新增可选 `environment` 查询参数 - [更新 MCP 工具配置](/docs/zh/api-reference/mcp/tool-configuration/update) - `PATCH /v1/convai/mcp-servers/{mcp_server_id}/tool-configs/{tool_name}` - 新增可选 `environment` 查询参数 ### 工作区 - [邀请用户](/docs/zh/api-reference/workspace/invites/create) - `POST /v1/workspace/invites/add` - 新增可选 `usage_limit`，用于限制受邀者每月额度上限 - [邀请多位用户](/docs/zh/api-reference/workspace/invites/create-batch) - `POST /v1/workspace/invites/add/bulk` - 新增可选 `usage_limit`，用于限制受邀者每月额度上限 ## 架构变更 ### ElevenAgents - 系统工具 - 新增 `run_subagent`（`RunSubagentToolConfig`），包含必填 `agents` 数组 - 平台设置 - 新增可选 `sentiment_analysis`（`SentimentAnalysisSettings`） - 新增可选 `auto_translate_transcript_to_app_language`（布尔值） - 工作流 - 新增嵌套 `AgentTransfer` 模型，支持 `AgentTransferOp` push、pop 和 replace - 转录文本 - 用户轮次模型新增可选 `ignored_as_backchannel`（布尔值） - 工具和 MCP - 工具配置模型新增 `tool_call_sound: "off"` 覆盖支持 - 智能体 TTS 设置中的 `optimize_streaming_latency` 已弃用（无实际作用） - 电话通信 - Twilio 电话号码导入请求新增可选 `enable_sms`（布尔值） - 知识库 - 将 `ExternalSyncType` 重命名为 `ExternalSyncProvider` - 新增 `KbExternalSyncJob`、同步任务触发器和类型枚举 - 文件夹响应新增可选 `active_sync_job` - 情感 - 扩展 `SentimentAggregate`，加入近期窗口计数和平均分数 ### 工作区 - 服务账号 - 为创建响应新增 `WorkspaceCreateServiceAccountResponseModel` - 创建请求新增可选 `default_sharing_groups` - 成员 - 为列表响应新增 `WorkspaceMemberResponseModel` - 邀请 - 单个和批量邀请请求正文新增可选 `usage_limit` ## July 6, 2026 ### 音乐 - **流式获取含详细信息的音乐**：新增 [流式获取含详细信息的音乐](/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 ## 新增端点 ### 音乐 - [流式获取含详细信息的音乐](/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` 动画类型 ## June 29, 2026 ### ElevenAgents - **分支合并和变基预览**：新增 [预览合并配置](/docs/zh/api-reference/agents/branches/preview)（`GET /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge-preview`）和预览变基配置（`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/rebase-preview`），可在提交前检查合并或变基后的智能体配置。两者均返回 `MergePreviewResponseModel`，其中包含最终配置、`overridden_fields` 和 `source_identical_to_target`。 - **分支用量指标**：[列出智能体分支](/docs/zh/api-reference/agents/branches/list)的分支摘要响应新增可选 `calls_7d`（整数），用于显示每个分支过去 7 天的通话量。 - **身份验证连接状态**：工作区身份验证连接响应模型将仅适用于 OAuth 的 `OAuthConnectionStatus` 替换为通用 `AuthConnectionStatus`（`active`、`refresh_failed`、`revoked`、`credential_invalid`）。Bearer、Basic、mTLS、自定义请求头、OAuth、OAuth2 JWT、Slack、URL 密钥和 WhatsApp 身份验证响应新增可选 `status`、`status_detail` 和 `status_updated_at` 字段。 - **工具响应过滤**：HTTP 和智能体工具配置架构新增可选 `response_filter`，用于在工具响应到达 LLM 前进行精简；相关覆盖模型新增 `response_filter_mode` 和 `response_filters`。 - **工作流电话转接**：工作流电话号码转接节点新增可选 `uui`（`UUITransferConfig`），用于通过 SIP REFER 转接传递 RFC 7433 十六进制用户间信息。 - **电话智能体分配**：Twilio、Exotel 和 SIP 中继电话号码导入请求架构新增可选 `agent_id`（字符串），可在号码设置期间分配智能体。 - **禁用打断时转录**：轮次配置架构新增可选 `transcribe_on_disabled_interruptions`（布尔值，默认 `false`），用于控制禁用打断时是否转录用户语音。 - **对话情感**：对话摘要架构新增可选 `sentiment_analysis`。对话用户模型新增可选 `sentiment`，包含受挫对话引用。 ### 语音转文本 - **合并多声道输出**：[将语音转换为文本](/docs/zh/api-reference/speech-to-text/convert)在启用 `use_multi_channel` 时新增可选 `multichannel_output_style`（默认 `separate`｜`combined`）。设为 `combined` 可获取按时间合并和排序的单份转录，而非按声道分别返回的转录。启用多声道模式时，词级响应会为每个词提供 `channel_index`。 ### 文本转语音 - **`language_code` 行为 **：TTS 请求架构明确说明，不支持的 `language_code` 值会被忽略而非拒绝，并且 `multilingual_v2` 模型不支持 `language_code`。 ### 工作区 - **第三方 API 密钥禁用策略**：新增 [设置工作区第三方禁用策略](/docs/zh/api-reference/api-keys/set-third-party-disabling-policy)（`POST /v1/workspaces/api-keys/third-party-disabling`），可在整个工作区内控制 API 密钥持有者能否通过第三方禁用端点自行禁用密钥。工作区 API 密钥创建、修补和响应模型新增可选 `third_party_disable_allowed`（布尔值）。 - **Bearer 身份验证连接更新**：[更新工作区身份验证连接](/docs/zh/api-reference/workspace/auth-connections/update)请求联合新增 `UpdateBearerAuthRequest`，用于更新 Bearer 令牌凭据。 - **工作区权限**：权限枚举新增 `conversation_privacy_manage` 和 `synthid_detector`。工作区群组模型新增可选 `scim_group`（字符串）。 ### SDK 发布 #### JavaScript SDK - [v2.55.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.55.0) - 根据最新 OpenAPI 架构重新生成，包含分支合并和变基预览客户端、分支通话量指标、身份验证连接状态字段、工具响应过滤类型、语音转文本合并多声道输出及工作区第三方 API 密钥禁用策略。 #### Python SDK - [v2.55.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.55.0) - 根据最新 OpenAPI 架构重新生成，包含分支合并和变基预览客户端、分支通话量指标、身份验证连接状态字段、工具响应过滤模型、语音转文本合并多声道输出及工作区第三方 API 密钥禁用策略。 #### 软件包 - [@elevenlabs/client@1.13.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.13.0) - `sendFeedback(like, eventId?)` 接受可选的 `event_id`，可为特定历史消息评分。`canSendFeedback` 现会反映连接状态，因此会话进行期间可为任意消息发送反馈。 - [@elevenlabs/client@1.14.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.14.0) - `sendFeedback` 接受 `null` 作为第一个参数，以清除某个事件的反馈（`score: null`）。 - [@elevenlabs/react@1.8.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.8.0) 和 [@elevenlabs/react@1.9.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.9.0) - 在 React hooks 中公开了 `@elevenlabs/client@1.13.0` 和 `@elevenlabs/client@1.14.0` 的按消息反馈及清除反馈 `sendFeedback` 变更。 - [@elevenlabs/react-native@1.2.11](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.11) 和 [@elevenlabs/react-native@1.2.12](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.12) - 依赖项已与 `@elevenlabs/client@1.13.0`–`1.14.0` 和 `@elevenlabs/react@1.8.0`–`1.9.0` 对齐。 - [@elevenlabs/types@0.16.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.16.0)、[@elevenlabs/convai-widget-core@0.14.6](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.6)–[0.14.8](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.8) 和 [@elevenlabs/convai-widget-embed@0.14.6](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.6)–[0.14.8](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.8) - 依赖项已与 `@elevenlabs/client@1.13.0`–`1.14.0` 对齐。 #### Android SDK - [v0.10.0](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.10.0) - 将协调后的消息转录公开为 `StateFlow`。已弃用文本和智能体回调，改用事件 ID 变体。 - [v0.11.0](https://github.com/elevenlabs/elevenlabs-android/releases/tag/v0.11.0) - 新增音频帧回调，可在对话期间逐帧检查音频。 #### iOS SDK - [v3.2.2](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.2.2) - 修复了 LiveKit 房间委托方法实现，确保正确处理房间事件。 ### API ## 新增端点 ### ElevenAgents - `GET /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge-preview` - 在合并前预览合并后的配置 - `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/rebase-preview` - 在变基前预览变基后的配置 ### 工作区 - `POST /v1/workspaces/api-keys/third-party-disabling` - 设置工作区第三方 API 密钥禁用策略 ## 更新的端点 ### ElevenAgents - [列出智能体分支](/docs/zh/api-reference/agents/branches/list) - `GET /v1/convai/agents/{agent_id}/branches` - 分支摘要响应新增可选 `calls_7d`（整数） - [预览合并配置](/docs/zh/api-reference/agents/branches/preview) - `GET /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge-preview` - 返回 `MergePreviewResponseModel`，包含合并后的配置、`overridden_fields` 和 `source_identical_to_target` - 预览变基配置 - `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/rebase-preview` - 返回 `MergePreviewResponseModel`，包含变基配置预览 ### 语音转文本 - [将语音转换为文本](/docs/zh/api-reference/speech-to-text/convert) - `POST /v1/speech-to-text` - 启用 `use_multi_channel` 时新增可选 `multichannel_output_style`（`separate`｜`combined`） - 多声道模式下，词级响应会为每个词提供 `channel_index` ### 工作区 - [设置工作区第三方禁用策略](/docs/zh/api-reference/api-keys/set-third-party-disabling-policy) - `POST /v1/workspaces/api-keys/third-party-disabling` - 控制 API 密钥持有者能否通过第三方禁用流程自行禁用密钥 - [更新工作区身份验证连接](/docs/zh/api-reference/workspace/auth-connections/update) - `PATCH /v1/workspace/auth-connections/{auth_connection_id}` - 请求联合新增 `UpdateBearerAuthRequest` ## 架构变更 ### ElevenAgents - 身份验证连接 - 将 `OAuthConnectionStatus` 替换为 `AuthConnectionStatus`（`active`、`refresh_failed`、`revoked`、`credential_invalid`） - 身份验证连接响应模型新增可选 `status`、`status_detail` 和 `status_updated_at` - 工具和工作流 - HTTP 和智能体工具配置新增可选 `response_filter` - 转接相关工作流模型新增可选 `uui`（`UUITransferConfig`） - 轮次配置 - 新增可选 `transcribe_on_disabled_interruptions`（布尔值，默认 `false`） - 电话导入 - Twilio、Exotel 和 SIP 中继导入请求架构新增可选 `agent_id` - 对话模型 - 对话摘要类型新增可选 `sentiment_analysis` - 对话用户模型新增可选 `sentiment` ### 文本转语音 - 明确说明不支持时会忽略 `language_code`，且 `multilingual_v2` 不支持该字段 ### 工作区 - API 密钥 - 创建、修补和响应模型新增可选 `third_party_disable_allowed`（布尔值） - 权限 - 新增 `conversation_privacy_manage` 和 `synthid_detector` - 群组 - 工作区群组模型新增可选 `scim_group`（字符串） _Showing the 20 most recent of 101 entries. Append `/llms.txt` to the changelog URL for the complete index._