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 to get a short-lived secret, and the browser uses it to connect directly.
Realtime Translation
Realtime Translation turns speech in one language into speech in another while the speaker is still talking. It’s a WebSocket API, 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.
Video to Music
Video to Music writes a soundtrack for your video. The 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.
ElevenAgents
- Alerts: 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.alertingon Update agent. Notifications can be delivered as webhooks, to Slack or to PagerDuty. - Guardrails generally available: Guardrails are no longer in alpha.
- Workspace environments: Environments for environment variables can now be managed through the API with List environments, Create environment and Delete environment. A variable without a value for an environment falls back to its
productionvalue. Deleting an environment removes its values from all variables, andproductioncannot be deleted. - Answering machine detection actions: Twilio answering machine detection settings on Outbound call and Submit batch call accept
actions, a list of rules that pair anaction(hang_up) with theanswered_byverdicts that trigger it, such asmachine_startorfax. Verdicts without a rule leave the call running. - New LLMs: Agents can use
gemini-4-argon,claude-opus-4-6and the ElevenLabs-hostednemotron-35-super-vl-nvfp4. See Models. - Authored-only workflow reads: Get agent and Update agent accept
include_procedure_generated_workflow_elements. Set it tofalseto receive only the workflow nodes and edges you authored, excluding the ones compiled from structured procedures. Defaults totrue, so existing callers are unchanged. - Branch rebasing from any branch: Rebase branch and Preview rebase accept an optional
source_branch_idto pull changes from a branch other than main. - Delete agents used as subagents: Delete agent accepts
force. Whentrue, 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 accepts
sort_by=updated_at, and each agent summary includesupdated_at_unix_secs, the last time the main branch or agent-level settings changed. - Google Calendar event updates: The Google Calendar integration adds
google_calendar_update_eventandgoogle_calendar_delete_eventtools. 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, accept
enable_logging=falseto use Zero Retention Mode. Zero Retention Mode is available to enterprise customers. Music requests that setstore_for_inpainting=trueare rejected in this mode. - WAV output for sound effects: Sound Effects accepts
wav_8000,wav_16000,wav_22050,wav_24000,wav_32000,wav_44100andwav_48000output formats.
Speech Engine
- 40-minute conversations: Speech Engine supports conversations of up to 40 minutes. The default limit remains 10 minutes. Raise
conversation.max_duration_secondsto allow longer conversations. - Sort by last update: List Speech Engines accepts
sort_by=updated_at, and each summary includesupdated_at_unix_secs.
Dubbing
- Subtitles for dubbed languages: Dubbing project language outputs (
GET /v1/dubbing/project/{project_id}/language/{language_id}) includesubtitles, 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_statusaddsdeclined_resubmittablefor declined voices that can be resubmitted for review.
Workspaces
- Disable service account API keys: Disable service account API key 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 and List service accounts return
group_concurrency_limit,group_dubbing_concurrency_limitandgroup_music_concurrency_limitfor each group, and group permissions addall_resources_access.
SDK releases
JavaScript SDK
- v2.74.0 - Added
client.conversationalAi.realtime.createClientSecretfor the Realtime API, with theRealtimeModeland OpenAI-compatible session configuration types, and anenvironmentsclient withlist,createanddelete. Also addsforceon agent deletion,sourceBranchIdon branch rebase and rebase preview,includeProcedureGeneratedWorkflowElementson agent reads,enableLoggingon Music and Sound Effects methods, WAV output formats for Sound Effects, service account API keydisable, and Twilio answering machine detectionactions. - v2.73.0 - Added
createAndWaithelpers 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’sRetry-Afterheader. Afailedresult is returned rather than thrown, andwaitTimeoutInSecondsthrowsFlowsWaitTimeoutErrorif the work is not finished in time. The regenerated client adds the Video to musicadd_sfx,separate_tracksanduse_audio_as_referenceoptions.
Python SDK
- v2.74.1 -
music.compose_detailednow accepts and forwardsenable_logging, which the custom wrapper previously dropped, so Zero Retention Mode works with this method. - v2.74.0 - Added
client.conversational_ai.realtime.create_client_secretfor the Realtime API and anenvironmentsclient, with the same regenerated API changes as JavaScript SDK v2.74.0. - v2.73.0 - Added
create_and_waithelpers for Flows image, video and Text to Speech generations and template runs, for both sync and async clients, withwait_timeout_in_secondsandmin_poll_interval_in_secondsoptions and aFlowsWaitTimeoutErrorexported fromelevenlabs.flows_custom. Type checkers such as pyright now resolveclient.webhooks.construct_event,client.speech_to_text.realtime,client.text_to_speech.convert_realtimeand the custom Music methods. Includes the same regenerated API changes as the JavaScript SDK. - 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 - Regenerated API commands, adding environments, realtime client secrets and service account API key disabling.
- v1.6.0 - Added
create-and-waitcommands forflows image,flows video,flows text-to-speechandflows templates runs. Each command returns a finished result, with--wait-timeoutand--min-poll-intervaloptions. - v1.5.1, v1.5.2, v1.5.3 and v1.6.1 - Bug fixes for onboarding, including Windows support.
Packages
- @elevenlabs/client@1.28.0 - Added the experimental
persistentSessionoption for resumable text conversations over WebSocket, and theonConversationHistorycallback for the transcript the server replays on resume. WebSocket sessions now also emitonConversationMetadata. - @elevenlabs/react@1.18.0 - Forwards the experimental
onConversationHistorycallback to@elevenlabs/client. - @elevenlabs/types@0.25.0 - Added the
conversation_historyserver event and thepersistent_session_tokenfield onconversation_initiation_metadata. - @elevenlabs/react-native@1.2.30 - Updated to
@elevenlabs/client@1.28.0and@elevenlabs/react@1.18.0. - @elevenlabs/convai-widget-core@0.20.0 and @elevenlabs/convai-widget-embed@0.20.0 - Added the
persistent-sessionattribute. 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 and @elevenlabs/convai-widget-embed@0.19.1 - First message quick replies are shown below the first message in voice calls.
API
View API changes
New endpoints
ElevenAgents
-
Create realtime client secret -
POST /v1/convai/realtime/client_secrets- Create an ephemeral client secret for browser-based Realtime API sessions. Accepts an optionalsession(OpenAI-compatible session configuration withmodelofeleven_realtime_v1_mini(default) oreleven_realtime_v1_max,instructions,audio,tools,turn_detectionandmax_duration_secondsfrom 60 to 7,200, default 600) and optionalexpires_afterwith requiredseconds(integer). Returnsvalue(string),expires_at(integer) and the echoedsession. -
List environments -
GET /v1/convai/environments- List the workspace environments, includingproduction. Each environment hasname, nullableupdated_at_unix_secsand nullablecreated_by_user_id. -
Create environment -
POST /v1/convai/environments- Create an environment with a required, uniquename(string). Returns409if the name is taken. -
Delete environment -
DELETE /v1/convai/environments/{environment}- Delete an environment and remove its values from all environment variables. Returns204.
Workspaces
- Disable service account API key -
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, Update agent, Preview rebase and Preview merge
- Added optional
include_procedure_generated_workflow_elements(boolean, defaulttrue). Whenfalse, the returned workflow contains only authored nodes and edges, without those generated from structured procedures.
- Added optional
- Create agent, Get agent and Update agent
- The
llmenum addsgemini-4-argon,claude-opus-4-6andnemotron-35-super-vl-nvfp4. - TTS configuration
effectsremoves the deprecatedseedfield.
- The
- Delete agent - Added optional
force(boolean, defaultfalse). - List agents -
sort_byaddsupdated_at. Agent summaries add requiredupdated_at_unix_secs(integer). - Rebase branch and Preview rebase - Added optional
source_branch_id(string). Defaults to the agent’s main branch. - Outbound call, Submit batch call and Get batch call
- Twilio machine detection configuration adds
actions, an array of rules with requiredaction(hang_up) and requiredanswered_by(array ofhuman,fax,unknown,machine_start,machine_end_beep,machine_end_silenceormachine_end_other). Each action can appear in at most one rule.
- Twilio machine detection configuration adds
- Get conversation details
- 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_agentandto_node(string). - WhatsApp conversation info adds nullable
recipientwith nullablephoneandbsuid(string), and nullablecall_permission_requestwith requiredstate(blocked,sent,acceptedordeclined) and nullablerequested_at_unix(integer). - The platform charge category enum adds
v3_addon,v4_addonandrag_addon.
- Transcript tool calls add nullable
- Get ticket, List tickets and List workspace tickets
- Ticket responses add required
status_changes, an array of objects withstatus, nullablechanged_by_user_id(string) andchanged_at_unix_secs(integer).
- Ticket responses add required
Text to Speech and Text to Dialogue
- Create speech, Stream speech, Create dialogue and Stream dialogue, including their timestamp variants -
use_pvc_as_ivcis now nullable and no longer declares a default offalse.
Music
- Compose music, Compose detailed, Stream music, Compose detailed stream, Separate stems, Video to music and
POST /v1/music/plan- Added optional
enable_loggingquery parameter (boolean, defaulttrue). Set it tofalsefor Zero Retention Mode.
- Added optional
- Video to music - Added optional
add_sfx,separate_tracksanduse_audio_as_reference(boolean, defaultfalse).
Sound Effects
- Create sound effect
- Added optional
enable_loggingquery parameter (boolean, defaulttrue). output_formataddswav_8000,wav_16000,wav_22050,wav_24000,wav_32000,wav_44100andwav_48000.
- Added optional
Speech Engine
- List Speech Engines -
sort_byaddsupdated_at. Summaries add requiredupdated_at_unix_secs(integer).
Speech to Text
- Create transcript and Get transcript - Edited transcripts add required, read-only
edited_text(string), matchingtextand theedited_textfield of the realtimeedited_transcriptevent.
Dubbing
GET /v1/dubbing/project/{project_id}/languageandGET /v1/dubbing/project/{project_id}/language/{language_id}- Language outputs add nullablesubtitles(string, signed URL).
Voices
- Get voice, List voices and Get voices - Voice sharing
review_statusaddsdeclined_resubmittable.
Workspaces
- List workspace groups and List service accounts
- Groups add nullable
group_concurrency_limit,group_dubbing_concurrency_limitandgroup_music_concurrency_limit(integer orunlimited). - Group permissions add
all_resources_access.
- Groups add nullable
ElevenAgents
- Merge and search triage tickets: Merge tickets folds up to 50 open tickets from the same agent into one target ticket. Merged tickets keep the status
mergedand reference the target throughmerged_into_ticket_id. List tickets and List workspace tickets add a case-insensitivesearchparameter that matches ticket titles, descriptions, comments and turn comments, and each result includes asearch_matchexcerpt showing where the query matched. - Workflow End node outcomes: Workflow End nodes accept an
outcomeofsuccess(default) orfailure, so a workflow can record whether a conversation ended successfully. The conversation error type addsworkflow_end_failure. - Call queueing enabled for new agents: New agents are created with call queueing enabled unless
platform_settings.queueing_config.enabledis set explicitly. Existing agents keep their current setting. - Post-call audio webhook retries: When Enable retries is on,
post_call_audiowebhooks 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_strictmakes an overriddentool_idslist 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_enabledin the widget configuration or theend-confirmationattribute.
Text to Speech
- Audio effects: Text to Speech and Text to Dialogue requests accept an optional
audio_effectsobject. 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 withGET /v1/audio-effects/catalog. Reverb and non-zero panning produce stereo audio and are rejected forulaw_*,alaw_*andpcm_*output formats. Effects do not change the cost of a request.
Speech to Text
- Turn prediction commit strategy: The realtime Speech to Text WebSocket adds
turn_predictionas acommit_strategyvalue. 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 includeturn_probability. See 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.
Workspaces
- Basic seat fallback: Update member 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 returns the
workspace_idof the workspace the API key belongs to.
SDK releases
JavaScript SDK
- 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 theturn_predictioncommit strategy.
Python SDK
- 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 theturn_predictioncommit strategy.play()andsave()now accept any iterable of audio chunks, such as a list or tuple.RealtimeEvents.CLOSEhandlers receive a dictionary with the WebSocket closecodeandreason; handlers without parameters continue to work.
ElevenLabs CLI
- 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 and @elevenlabs/react@1.17.0 - Added a
previousTextoption toScribe.connect()anduseScribe()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.MediaDeviceOutputnow receiveslibsampleratePath, so output resampling uses the same custom libsamplerate bundle path asMediaDeviceInput. - @elevenlabs/react-native@1.2.29 - Updated to
@elevenlabs/client@1.27.0and@elevenlabs/react@1.17.0. - @elevenlabs/convai-widget-core@0.19.0 and @elevenlabs/convai-widget-embed@0.19.0 - Added an optional confirmation dialog before ending a chat or call, enabled with the
end-confirmationattribute orend_confirmation_enabledconfig, 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
View API changes
New endpoints
ElevenAgents
- Merge tickets -
POST /v1/convai/triage-tickets/{agentqa_ticket_id}/merge- Merge open tickets into the target ticket. Requiressource_ticket_ids(string array, 1–50 items) and returns the target ticket.
Voices
- List voice collections -
GET /v1/voices/collections- List the voice collections the caller can access, sorted by title. - Create voice collection -
POST /v1/voices/collections- Create a collection with requiredtitleandicon(string, maximum 1,000 characters each). - Get voice collection -
GET /v1/voices/collections/{collection_id}- Retrieve a collection with itstitle,iconand the caller’spermission_on_resource(admin,editor,commenterorviewer). - Update voice collection -
PATCH /v1/voices/collections/{collection_id}- Update the optionaltitleoricon. - Delete voice collection -
DELETE /v1/voices/collections/{collection_id} - Add voice to collection -
POST /v1/voices/collections/{collection_id}/voice/{voice_id} - Remove voice from collection -
DELETE /v1/voices/collections/{collection_id}/voice/{voice_id}
Audio effects
GET /v1/audio-effects/catalog- List the availablefilter_presets,environmentsandbackground_noises. Each entry has an ID, anameand a nullabledescription.
Updated endpoints
ElevenAgents
- Create agent, Get agent and Update agent
- Workflow End nodes add
outcome(successorfailure, defaultsuccess). 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 aconfiguredbranch reason. - Prompt override configurations add
tool_ids_strict(boolean, defaultfalse). - TTS configuration
effectsaddpan(number, -1 to 1, default0). Theseedfield is deprecated and has no effect.
- Workflow End nodes add
- Get widget config - Added
end_confirmation_enabled(boolean, defaultfalse). - List tickets
- Added optional
search(string, maximum 200 characters) andmerged_into_ticket_id(string) query parameters. - Ticket responses add nullable
merged_into_ticket_idand nullablesearch_matchwithfield(title,description,commentorturn_comment),snippet,highlight_start,highlight_endand nullableturn_index.
- Added optional
- List workspace tickets - Added optional
agent_id,sources,priorities,sort_by(created_atorpriority, defaultcreated_at),owner_user_id,issue_type,label,merged_into_ticket_idandsearchquery parameters. - List tests - Added optional
created_by_user_id(string). Use@mefor the authenticated user. - List test invocations - Added optional
test_id(string),version_id(string),start_timeandend_time(integer, Unix seconds, inclusive) query parameters. - Update agent branch - Added optional
auto_rebase(boolean). Branch responses addauto_rebase(boolean, defaultfalse). - Get conversation details
- Twilio, SIP trunk and Exotel phone call metadata add nullable
call_resultwithanswered,voicemail,busy,no_answerandfailedvalues. - Batch call metadata adds nullable
cold_attempt(integer) and nullableconversation_type(initial,retry,callbackorredirect). - The conversation error type adds
workflow_end_failure.
- Twilio, SIP trunk and Exotel phone call metadata add nullable
- Knowledge base auto-sync
auto_discoveris deprecated and no longer has any effect.
Text to Speech
- Create speech, Stream speech, Create speech with timing and Stream speech with timing
- Added optional nullable
audio_effectswithfilter_preset_id(string),distance(number, 0–1, default0),environment_id(string),background_noise_id(string),send_level(number, 0–1, default1) andpan(number, -1 to 1, default0). - Unknown effect IDs return
404. Stereo effects return400forulaw_*,alaw_*andpcm_*output formats.
- Added optional nullable
Text to Dialogue
- Create dialogue, Stream dialogue, Create dialogue with timestamps and Stream dialogue with timestamps - Added optional nullable
audio_effects, matching the Text to Speech endpoints.
Speech to Text
- Realtime Speech to Text
- The
commit_strategyquery parameter addsturn_prediction, alongsidemanualandvad. partial_transcriptmessages add optionalturn_probability(number), sent only for models that predict turns.
- The
Music
POST /v1/music/video-to-music- Responses add asong-idheader with the ID of the generated song.
History
- List generated items - The history item
sourceenum addsVoicePreview.
Workspace and user
- Update member - Added optional
allow_downgrade_to_basic_seat(boolean, defaultfalse). - Get user - Added required
workspace_id(string). - Service account API key permissions add
voice_collections_readandvoice_collections_write.
ElevenAgents
- Structured procedures compile on save and publish: Update agent and Create agent draft now compile and validate 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 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.
SDK releases
JavaScript SDK
- 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 - 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 - Dynamic variables now preserve native JSON types when sent in conversation initiation data.
Packages
- @elevenlabs/client@1.26.0, @elevenlabs/react@1.16.0, @elevenlabs/react-native@1.2.28 and @elevenlabs/types@0.24.0 - Added realtime Speech to Text transcript editing through
transcriptEdit, theedited_transcriptevent and React’sonEditedTranscriptcallback. React now forwardsfilterBackgroundAudioto realtime sessions. The client also exportsMessagePayloadand uses stable response IDs to prevent duplicate agent replies. - @elevenlabs/convai-widget-core@0.18.3 and @elevenlabs/convai-widget-embed@0.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
View API changes
New endpoints
ElevenAgents
- Create a merge proposal -
POST /v1/convai/agents/{agent_id}/merge-proposals- Create a proposal with requiredsource_branch_id,target_branch_idandtitlefields, plus an optional description, reviewer IDs and triage ticket ID. - List merge proposals -
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 -
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 -
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 -
POST /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}/reviews- Submit anapprovedorchanges_requesteddecision with an optional comment. - Comment on a merge proposal -
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 -
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 -
GET /v1/convai/agents/{agent_id}/deployments- List current and historical branch traffic splits with page-based pagination. - Cancel a test invocation -
POST /v1/convai/test-invocations/{test_invocation_id}/cancel- Cancel a running test invocation.
Speech Engine
- Duplicate a Speech Engine -
POST /v1/speech-engine/{speech_engine_id}/duplicate- Duplicate a Speech Engine and optionally assign the copy a newname.
Updated endpoints
ElevenAgents
- Create agent, Get agent and Update agent
- Added
gpt-6.1-solandclaude-sonnet-5-5to theLLMenum. - Added
eleven_v4andeleven_v4_turboto the conversational TTS model options. The default changed fromeleven_flash_v2toeleven_v4_turbo. - Agent transfers and standalone workflow agent nodes add optional
preserve_voice_settings(boolean, defaultfalse) 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-1keeps the agent silent until the caller speaks. - Post-call webhook configurations add optional
exclude_transcript(boolean, defaultfalse) 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_secsnow accepts-1to wait indefinitely whenexpects_responseis enabled.
- Added
- List tickets
- Added optional
priorities(array) withlow,medium,highandurgentvalues. - Added
sort_bywithcreated_atandpriorityvalues; the default iscreated_at. - Ticket responses now require
title, nullablepriority, and apriority_changesarray. Ticket creation and update requests can setpriority, and ticket status addscancelled.
- Added optional
- List tools - Added optional nullable
used_by_agent_id(string) to return tools referenced by an agent’s main branch. - Export batch call results - Added optional nullable
limit(integer, minimum1) to export only the first recipients as a column preview. - List test invocations and Get test invocation
- Test invocation summaries add required
cancelled_count(integer) and optionalcancelled(boolean, defaultfalse). - Test run status adds
cancelled.
- Test invocation summaries add required
- Get conversation details - Transcript entries add optional nullable
platform_eventwithuser_turn_timeoutandskip_turn_wait_elapsedvalues. - Get agent version metadata - Added optional nullable
merged_authors, an array describing the people who published changes merged into the main branch. - Get crawl job - Removed the deprecated
max_depthresponse field.
Eleven v4 et Eleven v4 Turbo
Eleven v4 et Eleven v4 Turbo sont désormais disponibles. Eleven v4 offre une synthèse vocale de meilleure qualité et plus expressive, ainsi qu’un clonage de voix amélioré dans plus de 90 langues. Eleven v4 Turbo propose la même famille de modèles pour les applications en temps réel, avec une latence d’inférence médiane d’environ 100 ms.
Utilisez eleven_v4 via l’API Text to Dialogue pour la création de contenu et les contenus audio longs. Utilisez eleven_v4_turbo via le WebSocket Text to Dialogue pour les agents et les applications interactives.
Speech to Text
- Modification des transcriptions : la transcription par lot et en temps réel accepte désormais une instruction de modification en langage naturel pouvant contenir jusqu’à 2 000 caractères. Les réponses par lot renvoient le résultat dans
edited_transcript, tandis que les sessions en temps réel émettent un événementedited_transcript. Consultez les guides par lot et en temps réel pour connaître les incompatibilités, la gestion des réponses et la tarification.
ElevenAgents
- Modèles d’agent : ajout de
gpt-6-sol,gpt-6-luna,glm-52,deepseek-v41-flash,claude-opus-5etclaude-opus-5-5aux options de LLM d’agent prises en charge. - Utilisation des tests d’agent : les résumés d’invocation de test peuvent inclure le total de crédits et le prix en USD. Les exécutions de test individuelles peuvent inclure les crédits et le détail de la facturation.
Flows
- API de modèles : ajout de points de terminaison pour lister et récupérer les modèles Flows publiés, démarrer des exécutions de modèles et récupérer les résultats d’exécution. Les exécutions peuvent cibler une version publiée et envoyer leur résultat final à un webhook configuré.
Text to Dialogue
- Continuité de génération : les requêtes Text to Dialogue peuvent utiliser du texte précédent ou suivant et des identifiants de requête afin de maintenir la continuité entre les générations.
- Mode voix professionnelle : les requêtes Text to Dialogue peuvent utiliser la version Instant Voice Clone d’un Professional Voice Clone afin de réduire la latence ou d’améliorer l’expressivité.
Versions des SDK
SDK JavaScript
- v2.70.0 - Ajout des types de modification de transcription Speech to Text par lot et en temps réel, du filtrage
branchIdet des champs de coût pour les résumés d’invocation de test, de la découverte automatique de la base de connaissances, deusePvcAsIvcpour Text to Dialogue et du modèle d’agentdeepseek-v41-flash.
SDK Python
- v2.70.0 - Ajout des types de modification de transcription Speech to Text par lot et en temps réel, du filtrage
branch_idet des champs de coût pour les résumés d’invocation de test, de la découverte automatique de la base de connaissances, deuse_pvc_as_ivcpour Text to Dialogue et du modèle d’agentdeepseek-v41-flash.
CLI ElevenLabs
- v1.4.0 - Correction des requêtes utilisant une clé API explicite afin qu’elles n’envoient plus également les identifiants OAuth enregistrés, ce qui provoquait des échecs d’authentification. Ajout de descriptions pour le groupe de commandes de commentaires et d’instructions permettant de signaler les capacités manquantes aux compétences d’agent générées. Régénération du client API avec les points de terminaison de modèles Flows et les types de schéma actuels.
API
Voir les modifications de l’API
Nouveaux points de terminaison
Flows
- Lister les modèles -
GET /v1/flows/templates- Liste les modèles publiés et leurs versions exécutables. - Obtenir un modèle -
GET /v1/flows/templates/{template_id}- Récupère un modèle et ses versions exécutables. - Créer une exécution de modèle -
POST /v1/flows/templates/{template_id}/runs- Démarre une exécution de modèle avec des valeurs d’entrée, une version facultative et un webhook facultatif. - Lister les exécutions de modèles -
GET /v1/flows/templates/{template_id}/runs- Liste les exécutions de modèles avec pagination par curseur et filtrage facultatif par version. - Obtenir une exécution de modèle -
GET /v1/flows/templates/{template_id}/runs/{run_id}- Récupère une exécution de modèle et l’état de sa sortie.
Points de terminaison mis à jour
Speech to Text
- Convertir la parole en texte -
POST /v1/speech-to-text- Ajout de
transcript_editfacultatif et nullable (chaîne), qui accepte une instruction de modification en langage naturel pouvant contenir jusqu’à 2 000 caractères. - Les réponses ajoutent
edited_transcriptfacultatif et nullable. Une modification réussie contient les champs obligatoireskind: "transcript"ettext. Une modification échouée contient les champs obligatoireskind: "error",error_type: "edit_failed"etmessage.
- Ajout de
- Realtime Speech to Text accepte
transcript_edit(chaîne) et émet des événementsedited_transcriptavec les champs obligatoirestextetedited_text.
ElevenAgents
- Créer un agent, Obtenir un agent et Mettre à jour un agent
- Ajout de
gpt-6-sol,gpt-6-luna,glm-52,deepseek-v41-flash,claude-opus-5etclaude-opus-5-5à l’énumérationLLM. - Les moniteurs d’alerte ajoutent
enabledfacultatif et nullable (booléen) afin de contrôler si un moniteur peut envoyer des notifications.
- Ajout de
- Lister les conversations et Recherche textuelle
data_collection_paramsetdynamic_variable_paramsajoutent les opérateursneqetin. Les valeurs deinutilisent un séparateur de type barre verticale.evaluation_paramsacceptesuccess,failureouunknowncomme valeur de résultat.
- Recherche intelligente -
GET /v1/convai/conversations/messages/smart-search- Ajout de
branch_idfacultatif et nullable (chaîne).
- Ajout de
- Lister les invocations de test -
GET /v1/convai/test-invocations- Ajout de
branch_idfacultatif et nullable (chaîne). - Les résumés d’invocation de test ajoutent
credits_usedfacultatif et nullable (entier) ettotal_price(nombre).
- Ajout de
- Obtenir une invocation de test -
GET /v1/convai/test-invocations/{test_invocation_id}- Les exécutions de test individuelles ajoutent
credits_usedfacultatif et nullable (entier) etcharging(ConversationChargingCommonModel).
- Les exécutions de test individuelles ajoutent
- Simuler une conversation et Diffuser une simulation de conversation
- Modification de la valeur par défaut facultative de
new_turns_limit, de10,000à100, et définition de sa valeur maximale à100.
- Modification de la valeur par défaut facultative de
- Créer une tâche d’exploration et Obtenir une tâche d’exploration
- Ajout de
auto_discoverfacultatif (booléen, valeur par défautfalse) pour suivre les liens et ajouter les nouvelles pages découvertes lors de la synchronisation automatique. Nécessiteenable_auto_sync: true.
- Ajout de
- Actualiser un document de la base de connaissances -
POST /v1/convai/knowledge-base/{documentation_id}/refreshAutoSyncInfoajouteauto_discoverfacultatif (booléen, valeur par défautfalse) afin d’indiquer si les actualisations explorent et ajoutent les nouvelles pages découvertes.
- Lister les outils du serveur MCP -
GET /v1/convai/mcp-servers/{mcp_server_id}/tools- Les réponses ajoutent
tool_approval_statusesfacultatif (tableau). Chaque élément contienttool_idobligatoire (chaîne) etstate(up_to_date,needs_reviewounot_approved), avec des champs facultatifs de politique d’approbation et de définition approuvée.
- Les réponses ajoutent
Text to Dialogue
- Convertir du texte en dialogue, Diffuser du texte en dialogue, Convertir avec horodatages et Diffuser avec horodatages
- Ajout de
use_pvc_as_ivcfacultatif (booléen, valeur par défautfalse) pour utiliser la version Instant Voice Clone d’un Professional Voice Clone. - Ajout de
previous_textetfuture_textfacultatifs et nullables (chaînes, maximum 100 caractères), ainsi que deprevious_request_idsetnext_request_ids(tableaux de chaînes, maximum 3 identifiants) pour assurer la continuité de génération. - L’objet
settingsfacultatif ajoutesimilaritynullable (nombre, 0–1, valeur par défaut0.75).
- Ajout de
Text to Speech
- Convertir du texte en parole, Diffuser du texte en parole, Convertir avec horodatages et Diffuser avec horodatages
- Le champ
use_pvc_as_ivcexistant n’est plus obsolète.
- Le champ
Flows
- Créer une génération d’image, Créer une génération vidéo et Créer une exécution de modèle
- Les cibles de webhook nécessitent désormais un discriminateur
typeexplicite (allouids). Les valeurs par défaut précédentes ont été supprimées.
- Les cibles de webhook nécessitent désormais un discriminateur
Voice Design
- Créer une voix à partir d’un aperçu, Créer des aperçus de voix, Concevoir une voix et Remixer une voix
- Ajout d’une réponse
409lorsqu’une génération pour l’aperçu est déjà en cours. Réessayez la requête après avoir reçu cette réponse.
- Ajout d’une réponse
Workspaces
- Créer une clé API de compte de service -
POST /v1/service-accounts/{service_account_user_id}/api-keys- Ajout de
tts_concurrency_limit,music_concurrency_limitetdubbing_concurrency_limitfacultatifs et nullables (entiers) pour les clés API de compte de service Enterprise.
- Ajout de
- Mettre à jour une clé API de compte de service -
PATCH /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id}- Ajout de
tts_concurrency_limit,music_concurrency_limitetdubbing_concurrency_limitfacultatifs. Chaque champ accepte un entier,clear,no_updateounull, et utiliseno_updatepar défaut.
- Ajout de
Modèles
- Lister les modèles -
GET /v1/models- Dépréciation de
max_characters_request_free_useretmax_characters_request_subscribed_user, auparavant obligatoires. Ces champs ne sont pas appliqués, utilisez plutôtmaximum_text_length_per_request.
- Dépréciation de
Image & Vidéo
- Sora 2 et Sora 2 Pro retirés : OpenAI met fin à l’API Sora le 24 septembre 2026. Les deux modèles ont été retirés du sélecteur de modèles Image & Vidéo et cesseront de générer à cette date. Les générations existantes restent disponibles dans votre historique. Les Flows et modèles qui utilisent un nœud Sora doivent être remplacés par un autre modèle vidéo, tel que Gemini Omni 1.1 Flash, avant de pouvoir être exécutés à nouveau.
- Seedance 1.5 Pro déprécié : ByteDance retire Seedance 1.5 Pro le 11 novembre 2026. Le modèle n’est plus proposé pour les nouvelles générations et cessera de fonctionner à cette date. Utilisez plutôt un modèle Seedance 2.0.
ElevenAgents
- Appels d’outils parallèles : la configuration des prompts de l’agent inclut désormais
enable_parallel_tool_calls(booléen, valeur par défauttrue). Lorsqu’il est activé, les modèles compatibles peuvent exécuter plusieurs outils au cours d’un même tour. - Modèles d’agent : ajout de
gpt-6-astraaux options LLM des agents. - Alertes : les alertes d’agent prennent désormais en charge les canaux Slack en plus des notifications PagerDuty et webhook.
- Recherche de numéros de téléphone : ajout d’un point de terminaison de numéros de téléphone paginé par curseur, avec des filtres pour le fournisseur, la prise en charge des appels sortants, l’agent et la branche attribués, le libellé et le numéro de téléphone.
Image et vidéo
- Modèles GPT Image 2.5 : la génération d’images prend désormais en charge
gpt-image-2.5-flareetgpt-image-2.5-sunburst. Les deux modèles acceptent jusqu’à 10 images de référence, des niveaux de qualité jusqu’àmax, 14 formats d’image fixes ainsi queauto, et une sortie en 1K, 2K ou 4K.
Speech Engine
- Délai d’expiration en cascade : les requêtes de création et de mise à jour de Speech Engine acceptent désormais
cascade_timeout_seconds(nombre, 2–15, valeur par défaut4) afin de contrôler le temps pendant lequel ElevenLabs attend un moteur de synthèse vocale en amont avant de réessayer.
Text to Speech
- Limites de tours multi-contexte : le marqueur
is_final_audio_for_turnest désormais émis après chaque octet mis en mémoire tampon pour ce tour, y compris pour les sorties MP3 et Opus. Les clients peuvent utiliser ce marqueur comme limite de tour exacte sans passer au PCM.
Versions des SDK
SDK JavaScript
- v2.69.0 - Ajout de
transcriptEditau wrapper Speech to Text en temps réel, avec du texte modifié transmis via les événementsedited_transcript. Correction de la vérification JWT de Speech Engine pour les clés API avec suffixes de résidence des données. Ajout dephoneNumbers.listV2et de méthodes de modèles Flows pour lister et obtenir des modèles, ainsi que lister, créer et obtenir des exécutions. Clients et types régénérés pour GPT Image 2.5, les alertes d’agent Slack, les appels d’outils parallèles,gpt-6-astra, les limites de requêtes simultanées des clés API de comptes de service, le mode zéro rétention de Music, les filtres de conversation et les statuts d’approbation des outils MCP.
SDK Python
- v2.69.0 - Ajout de
transcript_editau wrapper Speech to Text en temps réel, avec du texte modifié transmis via les événementsedited_transcript. Correction de la vérification JWT de Speech Engine pour les clés API avec suffixes de résidence des données, et modification deplayafin de générer une erreur en cas d’échec deffplay. Ajout dephone_numbers.list_v2et de méthodes de modèles Flows pour lister et obtenir des modèles, ainsi que lister, créer et obtenir des exécutions. Clients et types régénérés pour GPT Image 2.5, les alertes d’agent Slack, les appels d’outils parallèles,gpt-6-astra, les limites de requêtes simultanées des clés API de comptes de service, le mode zéro rétention de Music, les filtres de conversation et les statuts d’approbation des outils MCP.
CLI ElevenLabs
- v1.3.2 - Ajout de métadonnées facultatives
--intentpour recueillir des retours sur l’utilisation de la CLI. Ajout deelevenlabs feedback missing-capabilitypour signaler les workflows que la CLI ne prend pas en charge.
API
Voir les modifications de l'API
Nouveaux points de terminaison
ElevenAgents
- Lister une page de numéros de téléphone -
GET /v1/convai/v2/phone-numbers- Ajout des paramètres de pagination facultatifs
page_size(entier, 1–1 000, valeur par défaut100) etcursor(chaîne pouvant être nulle). - Ajout des filtres facultatifs
search,label,phone_number,provider,supports_outbound,agent_id,branch_id,sort_byetsort_direction.sort_byacceptelabelouphone_number;sort_directionutiliseascpar défaut. - La réponse contient
phone_numbers(tableau) obligatoire,next_cursor(chaîne) facultatif et pouvant être nul, ainsi quehas_more(booléen, valeur par défautfalse).
- Ajout des paramètres de pagination facultatifs
Points de terminaison mis à jour
ElevenAgents
- Créer un agent, Obtenir un agent et Mettre à jour un agent
- La configuration des prompts ajoute
enable_parallel_tool_calls(booléen, valeur par défauttrue). Les remplacements de workflow acceptent un booléen pouvant être nul. - L’énumération
LLMajoutegpt-6-astra, y compris pour les remplacements d’initialisation de conversation. - Les notifications d’intégration d’alertes utilisent désormais
integration_typepour sélectionnerpagerdutyouslack. Les notifications Slack requièrentconnection_idetchannel_id(chaînes) ;channel_idaccepte 1 à 64 caractères.
- La configuration des prompts ajoute
- Lister les conversations et Résoudre une référence de conversation
data_collection_paramsn’accepte plus l’opérateurmissing. Utilisez une valeur vide pour trouver les conversations dans lesquelles le champ n’a pas été collecté.- Une valeur vide dans
dynamic_variable_paramscorrespond aux conversations dans lesquelles la variable n’a pas été définie.
- Créer un Speech Engine, Obtenir un Speech Engine et Mettre à jour un Speech Engine
- Ajout de
cascade_timeout_seconds(nombre, 2–15). Les requêtes de création utilisent4par défaut, les requêtes de mise à jour acceptent une valeur pouvant être nulle et les réponses requièrent ce champ.
- Ajout de
Image et vidéo
- Créer une génération d’image -
POST /v1/flows/image- Ajout de variantes de requête pour
gpt-image-2.5-flareetgpt-image-2.5-sunburst. - Les deux variantes requièrent
promptetmodel_id, acceptent jusqu’à 10imageset ajoutentresolution(1K,2Kou4K, valeur par défaut1K). qualityacceptelow,medium,high,xhighoumaxet utilisehighpar défaut.aspect_ratioaccepteautoet 14 ratios fixes, et utilise16:9par défaut.
- Ajout de variantes de requête pour
Doublage
- Créer un projet de doublage -
POST /v1/dubbing/projectkeytermsmultipartite accepte des champs répétés ou un seul tableau JSON.webhook_idsmultipartite accepte des champs répétés, un seul tableau JSON ou une chaîne séparée par des virgules.
- Obtenir une ressource de Workspace, Partager une ressource de Workspace et Ne plus partager une ressource de Workspace
WorkspaceResourceTypeajoutedubbing_project.
Base de connaissances
- Créer une tâche d’exploration -
POST /v1/convai/knowledge-base/crawl- Dépréciation de
max_depth(entier, valeur par défaut3). Ce champ n’a désormais aucun effet et n’est plus soumis à des contraintes minimales ou maximales. - Les métadonnées des tâches d’exploration ne requièrent plus
max_depth.
- Dépréciation de
Utilisateur
- Obtenir un utilisateur et Obtenir un abonnement
- Les énumérations de devises ajoutent
gbp.
- Les énumérations de devises ajoutent
Modifications du schéma
Text to Speech
- Les messages WebSocket
audioetfinalmulti-contexte définissent désormaisis_final_audio_for_turncomme intervenant après la livraison de tous les octets mis en mémoire tampon pour le tour.
ElevenAgents
- Mise en file d’attente des appels et audio d’attente : ajout de la mise en file d’attente des appels pour les agents ayant atteint leur limite de requêtes simultanées. Les appelants en attente entendent un audio d’attente et reçoivent des événements
queue_statusjusqu’à leur admission ou l’expiration du délai. De nouvelles méthodes API permettent d’importer ou de supprimer un audio d’attente personnalisé. - Métadonnées des versions de test : les résultats des tests d’agent identifient désormais la version de l’agent sur laquelle ils ont été exécutés et indiquent s’ils incluaient des modifications de brouillon. Les récapitulatifs d’invocation signalent également lorsque des soumissions partielles ont été exécutées sur différentes versions.
- Métadonnées de modèle et de compte : la configuration LLM de l’agent accepte désormais
gemini-3.8-flash. Les réponses des comptes WhatsApp indiquent si le compte utilise l’API Cloud ou le processus d’inscription en coexistence.
Musique
- Prise en charge de l’API Music v2.5 : les points de terminaison Music et les SDK acceptent désormais
music_v2_5. Les segments de génération de plans de composition prennent en charge jusqu’à 6 132 caractères, avec jusqu’à 30 lignes de 200 caractères chacune.
Versions des SDK
SDK JavaScript
- v2.68.0 - Ajout de méthodes pour importer et supprimer l’audio d’attente d’un agent. Types régénérés pour la mise en file d’attente des appels, les références de procédures, la création de branches de brouillon, les limites de requêtes RAG, les métadonnées de versions de test,
gemini-3.8-flashetmusic_v2_5.
SDK Python
- v2.68.0 - Ajout de méthodes synchrones et asynchrones pour importer et supprimer l’audio d’attente d’un agent. Types régénérés pour la mise en file d’attente des appels, les procédures, la création de branches de brouillon, les limites de requêtes RAG, les métadonnées de versions de test,
gemini-3.8-flashetmusic_v2_5. Le wrappercompose_detailedaccepte désormais chaque ID de modèle de musique généré ainsi que les plans de composition basés sur des prompts et sur des segments.
SDK iOS
- v3.3.1 - Rapproche les messages de l’agent par
response_idplutôt que parevent_id, en préservant plusieurs réponses autour des appels d’outils et en évitant que des parties diffusées en streaming ou des corrections soient associées au mauvais message.
CLI ElevenLabs
- v1.3.0 - Ajout de métadonnées facultatives
--intentaux commandes API générées. Ajout deelevenlabs feedback missing-capabilitypour signaler les workflows que la CLI ne prend pas en charge.
Packages
- @elevenlabs/convai-widget-core@0.18.2 et @elevenlabs/convai-widget-embed@0.18.2 - Correction des réponses d’agent en double après les appels d’outils et de procédures. Les réponses textuelles diffusées en streaming conservent leur mise en forme Markdown, et les conversations vocales n’affichent plus les parties de chat diffusées mais non prononcées. Le package embed limite également les événements
user_activityà un par seconde et supprime cette limite à la fin d’une session.
API
Voir les modifications de l'API
Nouveaux points de terminaison
ElevenAgents
- Importer l’audio d’attente d’un agent -
POST /v1/convai/agents/{agent_id}/hold-audio- Accepte le champ obligatoire
hold_audio_file(binaire) sous forme de données de formulaire multipartites. Le fichier doit être au format MP3 ou WAV, ne pas dépasser 40 Mo ni 180 secondes. - Renvoie les champs obligatoires
agent_id(chaîne) ethold_audio(AgentHoldAudioConfig). L’objet d’audio d’attente requiertaudio_path,audio_url,original_filename(chaînes),duration_secs(nombre) etsize_bytes(entier).
- Accepte le champ obligatoire
- Supprimer l’audio d’attente d’un agent -
DELETE /v1/convai/agents/{agent_id}/hold-audio- Supprime le clip personnalisé afin que les appelants en attente entendent la tonalité d’attente par défaut.
- Renvoie le champ obligatoire
agent_id(chaîne).
Points de terminaison mis à jour
ElevenAgents
- Créer un agent, Obtenir un agent et Mettre à jour un agent
- Ajout de
platform_settings.queueing_config(AgentQueueingConfig) facultatif, avecenabled(booléen, valeur par défautfalse) etwait_timeout_seconds(entier, 1–1 800, valeur par défaut180). - Les réponses de configuration de file d’attente incluent
hold_audio(AgentHoldAudioConfig) en lecture seule et pouvant être nul. Les réponses d’agent incluent égalementdefault_hold_audio_url(chaîne) facultatif.
- Ajout de
- Obtenir une conversation -
GET /v1/convai/conversations/{conversation_id}- Les métadonnées ajoutent
queue_wait_secs(nombre) facultatif et pouvant être nul. Le temps d’attente dans la file est exclu decall_duration_secset du temps facturé.
- Les métadonnées ajoutent
- Créer une branche d’agent -
POST /v1/convai/agents/{agent_id}/branches- Ajout de
include_draft(booléen, valeur par défautfalse) facultatif. Lorsqu’il est défini surtrue, une branche créée à partir de l’extrémité de la branche inclut l’ensemble des procédures de brouillon de l’appelant.
- Ajout de
- Lister les procédures et les points de terminaison de création, d’obtention et de brouillon des procédures
- Les éléments de liste ajoutent
referenced_tool_ids,referenced_kb_ids,referenced_procedure_idsetreferenced_dynamic_variables(tableaux de chaînes) facultatifs. - Les réponses d’agent et d’aperçu de fusion ajoutent
proceduresfacultatif, une map indexée par ID de procédure.
- Les éléments de liste ajoutent
- Lister les invocations de test -
GET /v1/convai/test-invocations- Ajout de
search(chaîne) facultatif et pouvant être nul pour filtrer les tests et les dossiers par nom.
- Ajout de
- Exécuter des tests sur un agent et Obtenir une invocation de test
- Les réponses d’invocation de suite de tests et d’exécution de test unitaire ajoutent
version_id(chaîne) facultatif et pouvant être nul, ainsi queran_against_draft(booléen, valeur par défautfalse) facultatif. - Les récapitulatifs d’invocation ajoutent également
runs_diverged_from_version(booléen, valeur par défautfalse) facultatif.
- Les réponses d’invocation de suite de tests et d’exécution de test unitaire ajoutent
POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query- Le corps de la requête ajoute les remplacements spécifiques à la requête
max_documents_length(entier, 1–50 000) etmax_retrieved_rag_chunks_count(entier, 1–20), facultatifs et pouvant être nuls.
- Le corps de la requête ajoute les remplacements spécifiques à la requête
- Obtenir un compte WhatsApp -
GET /v1/convai/whatsapp-accounts/{phone_number_id}- Ajout de
account_type(WhatsAppAccountType, valeur par défautcloud_api) facultatif. Les valeurs sontcloud_apietcoexistence.
- Ajout de
- Calculer l’utilisation LLM attendue -
POST /v1/convai/agent/{agent_id}/llm-usage/calculateLLMUsageCalculatorLLMResponseModelajouteprice_per_message(nombre) obligatoire.
Musique
MusicModelIDajoutemusic_v2_5pourPOST /v1/music/video-to-music,POST /v1/music/plan, Composer de la musique,POST /v1/music/detailed,POST /v1/music/detailed/stream,POST /v1/music/stream,POST /v1/music/uploadetPOST /v1/music/finetunes.GenerationChunk.textaugmentemaxLengthde 6 000 à 6 132 caractères pourPOST /v1/music/plan,POST /v1/music,POST /v1/music/detailed,POST /v1/music/detailed/stream,POST /v1/music/streametPOST /v1/music/upload. Les noms de sections peuvent contenir 1 à 100 caractères, et les segments peuvent contenir jusqu’à 30 lignes de 200 caractères chacune.
Modifications du schéma
ElevenAgents
- Les événements serveur en temps réel ajoutent
queue_status. Son champ obligatoirequeue_status_event.statusacceptewaiting,admittedoutimed_out;timed_outprécède le code de fermeture WebSocket4300. L’audio d’attente continue d’arriver sous forme d’événementsaudioclassiques. - L’énumération
LLMajoutegemini-3.8-flash, y compris pour les remplacements d’initialisation de conversation. - Les unions de résultats des outils système de conversation ajoutent
start_procedure_success,start_procedure_error,end_procedure_successetend_procedure_error. FeaturesUsageCommonModelajoute les statuts de fonctionnalité facultatifsfreeform_procedureetstructured_procedure.
Scribe v2 Medical
Scribe v2 Medical est désormais disponible pour tous. Il s’agit d’un modèle de reconnaissance vocale par lots spécialisé dans l’audio médical et clinique, facturé au même tarif que Scribe v2.
Transmettez scribe_v2_medical comme model_id dans Create transcript. L’invite par termes clés, la détection d’entités, la diarisation des locuteurs et le mode non verbatim fonctionnent de la même manière qu’avec Scribe v2.
ElevenAgents
- Tickets de conversation pour l’ensemble du Workspace : Ajout de List workspace tickets pour récupérer les tickets de triage de conversation de tous les agents accessibles. Filtrez par statut ou par responsable et utilisez la pagination par curseur pour récupérer jusqu’à 100 tickets par page.
- Filtres de conversation par variables dynamiques : List conversations et Text search conversation messages acceptent désormais des filtres
dynamic_variable_paramsrépétables. Utilisezname:op:valueaveceq,gt,gte,ltoulte; les opérateurs de comparaison exigent des valeurs numériques. - Détection de répondeur Twilio : Les configurations de téléphonie sortante et d’appels par lots prennent désormais en charge
twilio_machine_detectionfacultatif. Choisissezenablepour déterminer rapidement s’il s’agit d’une personne ou d’un répondeur, oudetect_message_endpour attendre la fin du message d’accueil de la messagerie vocale. Les résultats sont transmis via le nouvel événement webhookanswering_machine_detection. - Contraintes de valeurs pour la collecte de données : Les propriétés de collecte de données peuvent désormais utiliser
allowed_valuespour nommer une variable dynamique contenant les valeurs autorisées. Le champ précédentallowed_values_dynamic_variableest obsolète. - Métadonnées d’agent : Les réponses de List agent branches indiquent désormais la date de création d’un brouillon et s’il précède la pointe de la branche. Les résumés d’agent et de Speech Engine exigent désormais
voice_id. - URL sources de la base de connaissances : Les segments de requête RAG d’agent incluent désormais
source_url, obligatoire et nullable, qui contient l’URL suivie des documents URL. - Pièces jointes dans les réponses d’agent : Les événements WebSocket
agent_responseincluent désormaisattachmentsfacultatif. Chaque pièce jointe exigeurletnameet peut incluremime_type.
Workspaces
- Limites de plateforme des clés API : Les réponses de clés API de compte de service peuvent désormais inclure des
platform_limitsEnterprise pour les crédits, les clones vocaux professionnels et les requêtes simultanées TTS, Doublage et Musique.
Versions des SDK
SDK JavaScript
- v2.67.0 - Ajout de
dynamicVariableParamsaux requêtes de liste de conversations et de recherche textuelle. Régénération des types pour la détection de répondeur Twilio, les contraintes de valeurs de collecte de données, les limites de plateforme des clés API, les métadonnées de brouillon de branche d’agent et les URL sources de la base de connaissances.
SDK Python
- v2.67.0 - Ajout de
dynamic_variable_paramsaux méthodes synchrones et asynchrones de liste de conversations et de recherche textuelle. Régénération des types pour la détection de répondeur Twilio, les contraintes de valeurs de collecte de données, les limites de plateforme des clés API, les métadonnées de brouillon de branche d’agent et les URL sources de la base de connaissances. Le client de synthèse vocale en temps réel ne transmet plus la sentinelle d’omission interne à la connexion.
CLI ElevenLabs
- v1.2.0 - Ajout de la commande
elevenlabs sayet de sa compétence d’agent, régénération des liaisons de commandes API et définition deeleven_v3comme modèle TTS par défaut.
Packages
- @elevenlabs/client@1.25.0, @elevenlabs/react@1.15.2, @elevenlabs/react-native@1.2.27, @elevenlabs/convai-widget-core@0.18.1 et @elevenlabs/convai-widget-embed@0.18.1 - Réexportation de
MessageAttachmentdepuis@elevenlabs/clientafin que les utilisateurs puissent importer directement le type. - @elevenlabs/client@1.24.0, @elevenlabs/types@0.23.0, @elevenlabs/react@1.15.1, @elevenlabs/react-native@1.2.26, @elevenlabs/convai-widget-core@0.18.0 et @elevenlabs/convai-widget-embed@0.18.0 - Transmission des fichiers joints aux réponses d’agent à
onMessageet ajout du paramètre de session facultatifwebRtc.singlePeerConnection. Le widget localise également les boutons de salutation et corrige les réponses de chat textuel perdues ou dupliquées.
API
Afficher les modifications de l'API
Nouveaux points de terminaison
ElevenAgents
- List workspace tickets -
GET /v1/convai/triage-tickets- Liste les tickets de triage de conversation de chaque agent auquel l’appelant a accès, classés du plus récemment créé au plus ancien.
- Ajout des paramètres de requête facultatifs
page_size(entier, 1–100,100par défaut),status(AgentConversationTicketStatus),assignee_user_id(chaîne ouunassigned) etcursor(chaîne). - Renvoie
GetAgentConversationTicketsPageResponseModel.
Points de terminaison mis à jour
ElevenAgents
- List conversations -
GET /v1/convai/conversations- Ajout de
dynamic_variable_paramsfacultatif et nullable (tableau de chaînes répétable). Chaque valeur utilisename:op:value, oùopesteq,gt,gte,ltoulte.
- Ajout de
- Text search conversation messages -
GET /v1/convai/conversations/messages/text-search- Ajout de
dynamic_variable_paramsfacultatif et nullable (tableau de chaînes répétable) avec la même syntaxe.
- Ajout de
- Twilio outbound call, SIP trunk outbound call, Exotel outbound call et Submit batch calling
telephony_call_configutilise désormais des schémas d’entrée et de sortie distincts.- Ajout de
twilio_machine_detectionfacultatif et nullable (TwilioMachineDetectionConfig). Sonmodeaccepteenableoudetect_message_endet utiliseenablepar défaut. Ce paramètre est ignoré pour les fournisseurs autres que Twilio et les appels entrants.
- Import phone number -
POST /v1/convai/phone-numbers- Ajout de
account_auth_tokenfacultatif et nullable (chaîne) pour les importations de clés API Twilio afin de valider les signatures des webhooks entrants.
- Ajout de
Modifications du schéma
ElevenAgents
WebhookEventTypeajouteanswering_machine_detection.AgentBranchSummaryajoutedraft_created_atfacultatif et nullable (entier) ainsi quedraft_is_behind_tipfacultatif (booléen,falsepar défaut).AgentKnowledgeBaseRagChunkResponseModelajoutesource_urlobligatoire et nullable (chaîne).AgentSummaryResponseModeletSpeechEngineSummaryResponseajoutentvoice_idobligatoire (chaîne).AnalysisPropertyajoutenamefacultatif et nullable (chaîne) etallowed_values(AllowedValues).LiteralJsonSchemaPropertyajoute égalementallowed_values. Les deux déprécientallowed_values_dynamic_variable.DataCollectionResultCommonModelajoutenamefacultatif et nullable (chaîne).WorkspaceApiKeyResponseModelajouteplatform_limitsfacultatif et nullable (PlatformLimits).- L’outil MCP
Iconajoutethemefacultatif et nullable (lightoudark). SMBToolConfigajoute les variantes de paramètressend_custom_email,create_service_quote_requestetcreate_product_quote_request.- Les schémas de paramètres de requête des webhooks et la configuration des appels téléphoniques utilisent désormais des modèles d’entrée et de sortie distincts.
- Les événements WebSocket
agent_responseajoutentattachmentsfacultatif (tableau). Chaque élément exigeurletname(chaînes) et acceptemime_typefacultatif (chaîne).
ElevenCreative
ReferenceVideo.studio_cliputilise désormaisStudioClipLocatorau lieu deStudioClipReference. Les champs et le format de transmission sont inchangés.
ElevenAgents
- Saisie au clavier téléphonique : La configuration des conversations d’agent prend désormais en charge
dtmf_input_settingsfacultatif pour la saisie DTMF. Configurez le délai d’attente des chiffres, utilisez#comme terminateur et masquez les saisies au clavier dans les transcriptions, les journaux et les analyses. - Historique des pièces jointes de conversation : Les entrées de transcription de Get conversation incluent désormais
file_inputs, un tableau contenant l’ID, le nom, le type MIME et l’URL de chaque fichier joint. - Filtrage par balises d’agent : List agents accepte désormais un paramètre de requête
tagsfacultatif. Répétez le paramètre pour trouver les agents possédant l’une des balises fournies. - Contexte des campagnes par lots : Get conversation identifie désormais les appels par lots grâce à des métadonnées
campaignnullables contenant les champs obligatoirescampaign_idetcampaign_lead_id.
Musique
- Données visuelles de forme d’onde : Generate music detailed, Stream music with details et Upload music acceptent désormais
with_waveform_visualfacultatif (booléen,falsepar défaut). Les réponses ayant activé cette option renvoient un tableau d’entierswaveform_visualbasse résolution, avec quatre échantillons par seconde.
Doublage
- Comportement de pagination des projets : List Dubbing projects et List language targets limitent désormais
page_sizeà 1–100. Le filtrage par statut de projet inclutqueued, et les deux points de terminaison indiquent comment utilisernext_cursorpour récupérer la page suivante.
Versions des SDK
SDK JavaScript
- v2.66.0 - Ajout de
fileIdsàsendMultimodalMessage, permettant à un message d’inclure plusieurs fichiers joints.
SDK Python
- v2.66.0 - Ajout de
file_idsàsend_multimodal_message, permettant à un message d’inclure plusieurs fichiers joints.
SDK Android
- v0.12.2 - Préservation du callback
onUnhandledClientToolCalllors du raccordement des événements de session. Les appels d’outils client non gérés qui attendent une réponse reçoivent désormais la réponse d’erreur automatique au lieu de rester non résolus.
CLI ElevenLabs
- v1.1.0 - Régénération des liaisons de commandes API et ajout de l’attribution des requêtes à la portée des commandes pour les workflows ElevenAgents. Ces commandes ajoutent
cmd/<command>auUser-Agentde la CLI, ce qui permet de distinguer les requêtes de workflows tels queagents pushetagents create.
Packages
- @elevenlabs/client@1.23.0, @elevenlabs/react@1.15.0, @elevenlabs/types@0.22.1, @elevenlabs/react-native@1.2.25, @elevenlabs/convai-widget-core@0.17.1 et @elevenlabs/convai-widget-embed@0.17.1 - Ajout de
fileIdsàsendMultimodalMessage. Le client envoie les champsfileetfilespour assurer la compatibilité, et React expose l’API client mise à jour.
API
Afficher les modifications de l'API
Points de terminaison mis à jour
ElevenAgents
- List agents -
GET /v1/convai/agents- Ajout de
tagsfacultatif et nullable (tableau de chaînes). Répétez le paramètre de requête pour trouver toute balise fournie.
- Ajout de
- Create agent, Get agent et Update agent
- Ajout de
conversation_config.conversation.dtmf_input_settingsfacultatif et nullable (DTMFInputConfig). Il prend en chargedtmf_input_timeout(nombre, 0,5–10 secondes,2par défaut),hash_terminator(booléen,truepar défaut) etredact_input(booléen,falsepar défaut). - Ajout de
sip_refer_play_dialtonefacultatif (booléen,truepar défaut) à la configuration de transfert de numéro de téléphone. Définissez-le surfalsepour garder la branche d’appel d’origine silencieuse pendant la finalisation d’un transfert SIP REFER. - Les outils système de procédure de début et de fin acceptent désormais un
ProcedureVersionRefou unProcedureDraftRef. Les références de brouillon exigentprocedure_id(chaîne) et définissentversion_idsurnull.
- Ajout de
- Get conversation -
GET /v1/convai/conversations/{conversation_id}- Ajout de
file_inputs(tableau deConversationHistoryTranscriptFileInputResponseModel) aux entrées de transcription. Chaque élément exigefile_id,original_filename,mime_typeetfile_url(chaînes). - Ajout de
campaignfacultatif et nullable (BatchCallingCampaignInformation) aux métadonnées d’appels par lots. L’objet exigecampaign_idetcampaign_lead_id(chaînes). - Ajout de
dtmfàChatSourceMedium.
- Ajout de
- Les types de problèmes des tickets de triage de conversation ajoutent
incorrect_information,documentation_gap,platform_bugetwrong_action.
Musique
- Generate music detailed (
POST /v1/music/detailed) et Stream music with details (POST /v1/music/detailed/stream)- Ajout de
with_waveform_visualfacultatif (booléen,falsepar défaut). - Les réponses détaillées ajoutent
waveform_visualnullable (tableau d’entiers), échantillonné quatre fois par seconde de-1000à1000.
- Ajout de
- Upload music -
POST /v1/music/upload- Ajout de
with_waveform_visualfacultatif (booléen,falsepar défaut) et dewaveform_visualnullable (tableau d’entiers) dans la réponse.
- Ajout de
ElevenCreative
- Create Studio project et Create podcast
quality_presetaccepte désormaisnull, et sa valeur par défaut de schémastandarda été supprimée.
Doublage
- List Dubbing projects -
GET /v1/dubbing/projectpage_sizereste un entier facultatif avec une valeur par défaut de20, mais les valeurs sont désormais limitées à 1–100 au lieu d’être rejetées.- Le filtre
statusdocumente désormaisqueued,preparing,readyetfailed. - Transmettez le
next_cursorde la réponse précédente danscursor; omettez-le pour la première page.
- List language targets -
GET /v1/dubbing/project/{project_id}/languagepage_sizereste un entier facultatif avec une valeur par défaut de20, mais les valeurs sont désormais limitées à 1–100 au lieu d’être rejetées.- Le filtre
statusprend en chargequeued,processing,completed,staleetfailed. - Transmettez le
next_cursorde la réponse précédente danscursor; omettez-le pour la première page.
Modifications du schéma
Workspace
PendingSubscriptionSwitchResponseModel.next_tierajoutegrant.