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
- Strukturerade procedurer kompileras vid sparande och publicering: Uppdatera agent och Skapa agentutkast kompilerar och validerar nu strukturerade procedurer automatiskt. Integrationer behöver inte längre anropa kompileringsslutpunkten eller manuellt uppdatera det genererade workflowet. Ogiltiga procedurer returnerar fel per procedur som
400 procedure_validation_failed. Agenter utan strukturerade procedurer påverkas inte. - Slutpunkten för att kompilera procedurer är äldre: Kompilera procedurer är markerad som äldre och bör inte användas av nya integrationer. Den är fortfarande tillgänglig för befintliga anropare.
- Sammanfogningsförslag: Sammanfogningsförslag är tillgängliga i alfa. Team kan öppna ett förslag för en agentgren, granska konfigurationsändringar och testresultat, lämna kommentarer eller godkännandebeslut och sammanfoga godkända ändringar i en målgren. Se Sammanfogningsförslag.
SDK-versioner
JavaScript SDK
- v2.71.0 - Lade till klienter för sammanfogningsförslag för agenter, distributionshistorik, avbrytning av testanrop och duplicering av Speech Engine. Versionen lägger även till prioriteringar och sortering för triageärenden, exportgränser för batchsamtal,
gpt-6.1-sol,claude-sonnet-5-5, Eleven v4-röstmodeller för agenter och aktuella typer för agentkonfiguration.
Python SDK
- v2.71.0 - Lade till klienter för sammanfogningsförslag för agenter, distributionshistorik, avbrytning av testanrop och duplicering av Speech Engine. Versionen lägger även till prioriteringar och sortering för triageärenden, exportgränser för batchsamtal,
gpt-6.1-sol,claude-sonnet-5-5, Eleven v4-röstmodeller för agenter och aktuella typer för agentkonfiguration.
Swift SDK
- v3.4.0 - Dynamiska variabler bevarar nu ursprungliga JSON-typer när de skickas i data för konversationsinitiering.
Paket
- @elevenlabs/client@1.26.0, @elevenlabs/react@1.16.0, @elevenlabs/react-native@1.2.28 och @elevenlabs/types@0.24.0 - Lade till redigering av Speech to Text-transkript i realtid via
transcriptEdit, händelsenedited_transcriptoch Reacts callbackonEditedTranscript. React vidarebefordrar nufilterBackgroundAudiotill realtidssessioner. Klienten exporterar ävenMessagePayloadoch använder stabila svars-ID:n för att förhindra dubbla agentsvar. - @elevenlabs/convai-widget-core@0.18.3 och @elevenlabs/convai-widget-embed@0.18.3 - Lade till bildförhandsvisningar och nedladdningslänkar för bilagor i agentmeddelanden, inklusive svar med endast bilagor. Stabila svars-ID:n förhindrar dubbla svar, och konversationer med endast text använder nu en stoppkontroll med verktygstipset Avsluta chatt.
API
Visa API-ändringar
Nya slutpunkter
ElevenAgents
- Skapa ett sammanfogningsförslag -
POST /v1/convai/agents/{agent_id}/merge-proposals- Skapa ett förslag med obligatoriska fältensource_branch_id,target_branch_idochtitle, samt en valfri beskrivning, granskar-ID:n och ID för triageärende. - Lista sammanfogningsförslag -
GET /v1/convai/agents/{agent_id}/merge-proposals- Lista förslag med filter för status, källgren, målgren och text, samt cursor-paginering. - Hämta ett sammanfogningsförslag -
GET /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}- Hämta ett förslag och dess gransknings-, kommentars- och resultatdetaljer. - Uppdatera ett sammanfogningsförslag -
PATCH /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}- Uppdatera dess titel, beskrivning eller begärda granskare, eller stäng det utan att sammanfoga. - Granska ett sammanfogningsförslag -
POST /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}/reviews- Skicka ett beslut omapprovedellerchanges_requestedmed en valfri kommentar. - Kommentera ett sammanfogningsförslag -
POST /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}/comments- Lägg till en Markdown-kommentar på upp till 4 096 tecken. - Sammanfoga ett sammanfogningsförslag -
POST /v1/convai/agents/{agent_id}/merge-proposals/{merge_proposal_id}/merge- Sammanfoga källgrenen och styr valfritt framtvingad konfliktlösning och arkivering av källgrenen. - Lista agentdistributioner -
GET /v1/convai/agents/{agent_id}/deployments- Lista aktuella och historiska fördelningar av grenstrafik med sidbaserad paginering. - Avbryt ett testanrop -
POST /v1/convai/test-invocations/{test_invocation_id}/cancel- Avbryt ett pågående testanrop.
Speech Engine
- Duplicera en Speech Engine -
POST /v1/speech-engine/{speech_engine_id}/duplicate- Duplicera en Speech Engine och tilldela valfritt kopian ett nyttname.
Uppdaterade slutpunkter
ElevenAgents
- Skapa agent, Hämta agent och Uppdatera agent
- Lade till
gpt-6.1-solochclaude-sonnet-5-5iLLM-uppräkningen. - Lade till
eleven_v4ocheleven_v4_turbobland modellalternativen för konversations-TTS. Standardvärdet ändrades fråneleven_flash_v2tilleleven_v4_turbo. - Agentöverföringar och fristående agentnoder i workflow lägger till valfria
preserve_voice_settings(boolean, standardvärdefalse) för att behålla basrösten, TTS-modellen och röstinställningarna efter en överföring. - Verktygskonfigurationer för att hoppa över turer lägger till valfria
wait_timeout_secs(tal, standardvärde-1). Värdet-1håller agenten tyst tills uppringaren talar. - Webhook-konfigurationer efter samtal lägger till valfria
exclude_transcript(boolean, standardvärdefalse) för att utelämna tur-för-tur-transkript från JSON-transkriptionswebhooks. - Konfigurationer för maskering av konversationshistorik lägger till valfria
excluded_data_collection_ids(strängarray, högst 50) för att bevara utvalda extraherade värden samtidigt som deras motiveringar maskeras. - Klientverktygets
response_timeout_secsaccepterar nu-1för att vänta obegränsat närexpects_responseär aktiverat.
- Lade till
- Lista ärenden
- Lade till valfria
priorities(array) med värdenalow,medium,highochurgent. - Lade till
sort_bymed värdenacreated_atochpriority; standardvärdet ärcreated_at. - Ärendesvar kräver nu
title, nullbarapriorityoch enpriority_changes-array. Begäranden för att skapa och uppdatera ärenden kan angepriority, och ärendestatus lägger tillcancelled.
- Lade till valfria
- Lista verktyg - Lade till valfria nullbara
used_by_agent_id(sträng) för att returnera verktyg som refereras av en agents huvudgren. - Exportera resultat för batchsamtal - Lade till valfria nullbara
limit(heltal, minst1) för att endast exportera de första mottagarna som en kolumnförhandsvisning. - Lista testanrop och Hämta testanrop
- Sammanfattningar av testanrop lägger till obligatoriska
cancelled_count(heltal) och valfriacancelled(boolean, standardvärdefalse). - Testkörningsstatus lägger till
cancelled.
- Sammanfattningar av testanrop lägger till obligatoriska
- Hämta konversationsdetaljer - Transkriptposter lägger till valfria nullbara
platform_eventmed värdenauser_turn_timeoutochskip_turn_wait_elapsed. - Hämta metadata för agentversion - Lade till valfria nullbara
merged_authors, en array som beskriver personerna som publicerade ändringar som sammanfogats med huvudgrenen. - Hämta crawl-jobb - Tog bort det föråldrade svarsfältet
max_depth.
Eleven v4 och Eleven v4 Turbo
Eleven v4 och Eleven v4 Turbo är nu tillgängliga. Eleven v4 ger tal av högre kvalitet, mer uttrycksfullt tal och förbättrad röstkloning på fler än 90 språk. Eleven v4 Turbo erbjuder samma modellfamilj för realtidsapplikationer, med en medianlatens för inferens på cirka 100 ms.
Använd eleven_v4 via Text to Dialogue API för innehållsskapande och långformatljud. Använd eleven_v4_turbo via Text to Dialogue WebSocket för agenter och interaktiva applikationer.
Speech to Text
- Transkriptredigering: Batch- och realtidstranskribering accepterar nu en redigeringsinstruktion på naturligt språk på upp till 2 000 tecken. Batch-svar returnerar resultatet i
edited_transcript, medan realtidssessioner skickar enedited_transcript-händelse. Läs batch- och realtidsguiderna för inkompatibiliteter, svarshantering och prissättning.
ElevenAgents
- Agentmodeller: Lade till
gpt-6-sol,gpt-6-luna,glm-52,deepseek-v41-flash,claude-opus-5ochclaude-opus-5-5bland de LLM-alternativ som stöds för agenter. - Användning vid agenttester: Sammanfattningar av testanrop kan innehålla totalt antal krediter och pris i USD. Enskilda testkörningar kan innehålla krediter och en kostnadsuppdelning.
Flows
- Template API: Lade till slutpunkter för att lista och hämta publicerade Flows-mallar, starta mallkörningar och hämta körningsresultat. Körningar kan rikta in sig på en publicerad version och skicka slutresultatet till en konfigurerad webhook.
Text to Dialogue
- Kontinuitet vid generering: Text to Dialogue-förfrågningar kan använda föregående eller efterföljande text och förfrågnings-ID:n för att bibehålla kontinuitet mellan genereringar.
- Professionellt röstläge: Text to Dialogue-förfrågningar kan använda Instant Voice Clone-versionen av en Professional Voice Clone för att minska latensen eller förbättra uttrycksfullheten.
SDK-versioner
JavaScript SDK
- v2.70.0 - Lade till typer för redigering av Speech to Text-transkript i batch och realtid,
branchId-filtrering och kostnadsfält för sammanfattningar av testanrop, automatisk identifiering av kunskapsbaser, Text to DialogueusePvcAsIvcoch agentmodellendeepseek-v41-flash.
Python SDK
- v2.70.0 - Lade till typer för redigering av Speech to Text-transkript i batch och realtid,
branch_id-filtrering och kostnadsfält för sammanfattningar av testanrop, automatisk identifiering av kunskapsbaser, Text to Dialogueuse_pvc_as_ivcoch agentmodellendeepseek-v41-flash.
ElevenLabs CLI
- v1.4.0 - Åtgärdade förfrågningar med en uttrycklig API-nyckel så att de inte längre även skickar lagrade OAuth-autentiseringsuppgifter, vilket orsakade autentiseringsfel. Lade till beskrivningar för kommandogruppen för feedback och instruktioner för hur du rapporterar saknade funktioner till genererade agentfärdigheter. Genererade om API-klienten med Flows-mallslutpunkter och aktuella schematyper.
API
Visa API-ändringar
Nya slutpunkter
Flows
- Lista mallar -
GET /v1/flows/templates- Lista publicerade mallar och deras körbara versioner. - Hämta mall -
GET /v1/flows/templates/{template_id}- Hämta en mall och dess körbara versioner. - Skapa mallkörning -
POST /v1/flows/templates/{template_id}/runs- Starta en mallkörning med indatavärden, en valfri version och en valfri webhook. - Lista mallkörningar -
GET /v1/flows/templates/{template_id}/runs- Lista mallkörningar med cursor-paginering och valfri versionsfiltrering. - Hämta mallkörning -
GET /v1/flows/templates/{template_id}/runs/{run_id}- Hämta en mallkörning och dess utdata-status.
Uppdaterade slutpunkter
Speech to Text
- Konvertera tal till text -
POST /v1/speech-to-text- Lade till valfria nullbara
transcript_edit(sträng), som accepterar en redigeringsinstruktion på naturligt språk på upp till 2 000 tecken. - Svar lägger till valfria nullbara
edited_transcript. En lyckad redigering innehåller obligatoriska fältenkind: "transcript"ochtext. En misslyckad redigering innehåller obligatoriska fältenkind: "error",error_type: "edit_failed"ochmessage.
- Lade till valfria nullbara
- Realtids-Speech to Text accepterar
transcript_edit(sträng) och skickaredited_transcript-händelser med obligatoriska fältentextochedited_text.
ElevenAgents
- Skapa agent, Hämta agent och Uppdatera agent
- Lade till
gpt-6-sol,gpt-6-luna,glm-52,deepseek-v41-flash,claude-opus-5ochclaude-opus-5-5iLLM-uppräkningen. - Övervakare för aviseringar lägger till valfria nullbara
enabled(boolean) för att styra om en övervakare kan skicka aviseringar.
- Lade till
- Lista konversationer och Textsökning
data_collection_paramsochdynamic_variable_paramslägger till operatorernaneqochin. Värden förinanvänder pipe-avgränsare.evaluation_paramsaccepterarsuccess,failureellerunknownsom resultatvärde.
- Smart sökning -
GET /v1/convai/conversations/messages/smart-search- Lade till valfria nullbara
branch_id(sträng).
- Lade till valfria nullbara
- Lista testanrop -
GET /v1/convai/test-invocations- Lade till valfria nullbara
branch_id(sträng). - Sammanfattningar av testanrop lägger till valfria nullbara
credits_used(heltal) ochtotal_price(tal).
- Lade till valfria nullbara
- Hämta testanrop -
GET /v1/convai/test-invocations/{test_invocation_id}- Enskilda testkörningar lägger till valfria nullbara
credits_used(heltal) ochcharging(ConversationChargingCommonModel).
- Enskilda testkörningar lägger till valfria nullbara
- Simulera konversation och Streama simulerad konversation
- Ändrade standardvärdet för valfria
new_turns_limitfrån10,000till100och satte maxvärdet till100.
- Ändrade standardvärdet för valfria
- Skapa crawl-jobb och Hämta crawl-jobb
- Lade till valfria
auto_discover(boolean, standardvärdefalse) för att följa länkar och lägga till nyligen upptäckta sidor under automatisk synkronisering. Detta kräverenable_auto_sync: true.
- Lade till valfria
- Uppdatera kunskapsbasdokument -
POST /v1/convai/knowledge-base/{documentation_id}/refreshAutoSyncInfolägger till valfriaauto_discover(boolean, standardvärdefalse) för att ange om uppdateringar crawlar och lägger till nyligen upptäckta sidor.
- Lista MCP-serververktyg -
GET /v1/convai/mcp-servers/{mcp_server_id}/tools- Svar lägger till valfria
tool_approval_statuses(array). Varje objekt innehåller obligatoriskatool_id(sträng) ochstate(up_to_date,needs_reviewellernot_approved), med valfria fält för godkännandepolicy och godkänd definition.
- Svar lägger till valfria
Text to Dialogue
- Konvertera text till dialog, Streama text till dialog, Konvertera med tidsstämplar och Streama med tidsstämplar
- Lade till valfria
use_pvc_as_ivc(boolean, standardvärdefalse) för att använda Instant Voice Clone-versionen av en Professional Voice Clone. - Lade till valfria nullbara
previous_textochfuture_text(strängar, högst 100 tecken) samtprevious_request_idsochnext_request_ids(strängarrayer, högst 3 ID:n) för kontinuitet vid generering. - Det valfria objektet
settingslägger till nullbarasimilarity(tal, 0–1, standardvärde0.75).
- Lade till valfria
Text to Speech
- Konvertera text till tal, Streama text till tal, Konvertera med tidsstämplar och Streama med tidsstämplar
- Det befintliga fältet
use_pvc_as_ivcär inte längre föråldrat.
- Det befintliga fältet
Flows
- Skapa bildgenerering, Skapa videogenerering och Skapa mallkörning
- Webhook-mål kräver nu en uttrycklig
type-diskriminator (allellerids). De tidigare standardvärdena har tagits bort.
- Webhook-mål kräver nu en uttrycklig
Voice Design
- Skapa röst från förhandsvisning, Skapa röstförhandsvisningar, Designa en röst och Remixa en röst
- Lade till ett
409-svar när en generering för förhandsvisningen redan pågår. Försök igen efter att du har fått detta svar.
- Lade till ett
Arbetsytor
- Skapa API-nyckel för tjänstkonto -
POST /v1/service-accounts/{service_account_user_id}/api-keys- Lade till valfria nullbara
tts_concurrency_limit,music_concurrency_limitochdubbing_concurrency_limit(heltal) för API-nycklar till tjänstkonton för företag.
- Lade till valfria nullbara
- Uppdatera API-nyckel för tjänstkonto -
PATCH /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id}- Lade till valfria
tts_concurrency_limit,music_concurrency_limitochdubbing_concurrency_limit. Varje fält accepterar ett heltal,clear,no_updateellernulloch har standardvärdetno_update.
- Lade till valfria
Modeller
- Lista modeller -
GET /v1/models- Förklarade obligatoriska
max_characters_request_free_userochmax_characters_request_subscribed_usersom föråldrade. Dessa fält tillämpas inte; användmaximum_text_length_per_requesti stället.
- Förklarade obligatoriska
Bild och video
- Sora 2 och Sora 2 Pro har utgått: OpenAI avvecklar Sora API den 24 september 2026. Båda modellerna har tagits bort från modellväljaren för Bild och video och slutar generera på det datumet. Befintliga genereringar finns kvar i din historik. Flows och mallar som använder en Sora-nod måste bytas till en annan videomodell, till exempel Gemini Omni 1.1 Flash, innan de kan köras igen.
- Seedance 1.5 Pro har utfasats: ByteDance avvecklar Seedance 1.5 Pro den 11 november 2026. Modellen erbjuds inte längre för nya genereringar och slutar fungera på det datumet. Använd en Seedance 2.0-modell i stället.
ElevenAgents
- Parallella verktygsanrop: Agenters promptkonfiguration innehåller nu
enable_parallel_tool_calls(boolesk, standardvärdetrue). När det är aktiverat kan modeller som stöds köra flera verktyg i en och samma tur. - Agentmodeller: Lade till
gpt-6-astrai LLM-alternativen för agenter. - Aviseringar: Agentaviseringar har nu stöd för Slack-kanaler utöver PagerDuty- och webhook-aviseringar.
- Sökning efter telefonnummer: Lade till en markörpaginaterad telefonnummerändpunkt med filter för leverantör, utgående stöd, tilldelad agent och gren, etikett och telefonnummer.
Bild och video
- GPT Image 2.5-modeller: Bildgenerering har nu stöd för
gpt-image-2.5-flareochgpt-image-2.5-sunburst. Båda modellerna accepterar upp till 10 referensbilder, kvalitetsnivåer upp tillmax, 14 fasta bildförhållanden plusautosamt utdata i 1K, 2K eller 4K.
Speech Engine
- Tidsgräns för kaskad: Begäranden för att skapa och uppdatera Speech Engine accepterar nu
cascade_timeout_seconds(tal, 2–15, standardvärde4) för att styra hur länge ElevenLabs väntar på en uppströms talmotor innan ett nytt försök görs.
Text to Speech
- Turgränser för flera kontexter: Markören
is_final_audio_for_turnskickas nu efter varje buffrad byte för den turen, inklusive MP3- och Opus-utdata. Klienter kan använda markören som en exakt turgräns utan att byta till PCM.
SDK-versioner
JavaScript SDK
- v2.69.0 - Lade till
transcriptEditi realtidsomslaget för Speech to Text, med redigerad text som levereras viaedited_transcript-händelser. Åtgärdade JWT-verifiering för Speech Engine för API-nycklar med suffix för dataresidens. Lade tillphoneNumbers.listV2och Flows-mallmetoder för att lista och hämta mallar samt lista, skapa och hämta körningar. Återskapade klienter och typer för GPT Image 2.5, Slack-aviseringar för agenter, parallella verktygsanrop,gpt-6-astra, samtidighetsgränser för tjänstekonto-API-nycklar, nollagring för Music, konversationsfilter och godkännandestatusar för MCP-verktyg.
Python SDK
- v2.69.0 - Lade till
transcript_editi realtidsomslaget för Speech to Text, med redigerad text som levereras viaedited_transcript-händelser. Åtgärdade JWT-verifiering för Speech Engine för API-nycklar med suffix för dataresidens, och gjorde attplayger ett fel närffplaymisslyckas. Lade tillphone_numbers.list_v2och Flows-mallmetoder för att lista och hämta mallar samt lista, skapa och hämta körningar. Återskapade klienter och typer för GPT Image 2.5, Slack-aviseringar för agenter, parallella verktygsanrop,gpt-6-astra, samtidighetsgränser för tjänstekonto-API-nycklar, nollagring för Music, konversationsfilter och godkännandestatusar för MCP-verktyg.
ElevenLabs CLI
- v1.3.2 - Lade till valfri
--intent-metadata för att samla in feedback om användning av CLI:t. Lade tillelevenlabs feedback missing-capabilityför att rapportera arbetsflöden som CLI:t inte stöder.
API
Visa API-ändringar
Nya ändpunkter
ElevenAgents
- Lista telefonnummersida -
GET /v1/convai/v2/phone-numbers- Lade till valfria pagineringsparametrar för
page_size(heltal, 1–1 000, standardvärde100) ochcursor(nullable sträng). - Lade till valfria filter för
search,label,phone_number,provider,supports_outbound,agent_id,branch_id,sort_byochsort_direction.sort_byaccepterarlabelellerphone_number;sort_directionhar standardvärdetasc. - Svaret innehåller obligatoriska
phone_numbers(array), valfria nullablenext_cursor(sträng) ochhas_more(boolesk, standardvärdefalse).
- Lade till valfria pagineringsparametrar för
Uppdaterade ändpunkter
ElevenAgents
- Skapa agent, Hämta agent och Uppdatera agent
- Promptkonfiguration lägger till
enable_parallel_tool_calls(boolesk, standardvärdetrue). Åsidosättningar för arbetsflöden accepterar ett nullable booleskt värde. - Uppräkningen
LLMlägger tillgpt-6-astra, inklusive åsidosättningar för konversationsinitiering. - Aviserare för aviseringsintegreringar använder nu
integration_typeför att väljapagerdutyellerslack. Slack-aviseringar kräverconnection_idochchannel_id(strängar);channel_idaccepterar 1–64 tecken.
- Promptkonfiguration lägger till
- Lista konversationer och Lös konversationsreferens
data_collection_paramsaccepterar inte längre operatornmissing. Använd ett tomt värde för att matcha konversationer där fältet inte samlades in.- Ett tomt värde i
dynamic_variable_paramsmatchar konversationer där variabeln inte angavs.
- Skapa Speech Engine, Hämta Speech Engine och Uppdatera Speech Engine
- Lade till
cascade_timeout_seconds(tal, 2–15). Skapandebegäranden har standardvärdet4, uppdateringsbegäranden accepterar ett nullable värde och svar kräver fältet.
- Lade till
Bild och video
- Skapa bildgenerering -
POST /v1/flows/image- Lade till begärandevarianter för
gpt-image-2.5-flareochgpt-image-2.5-sunburst. - Båda varianterna kräver
promptochmodel_id, accepterar upp till 10imagesoch lägger tillresolution(1K,2Keller4K, standardvärde1K). qualityaccepterarlow,medium,high,xhighellermaxoch har standardvärdethigh.aspect_ratioaccepterarautooch 14 fasta förhållanden och har standardvärdet16:9.
- Lade till begärandevarianter för
Dubbning
- Skapa dubbningsprojekt -
POST /v1/dubbing/project- Multipart-
keytermsaccepterar upprepade fält eller en enda JSON-array. - Multipart-
webhook_idsaccepterar upprepade fält, en enda JSON-array eller en kommaseparerad sträng.
- Multipart-
- Hämta arbetsyteresurs, Dela arbetsyteresurs och Sluta dela arbetsyteresurs
WorkspaceResourceTypelägger tilldubbing_project.
Kunskapsbas
- Skapa crawlningsjobb -
POST /v1/convai/knowledge-base/crawl- Utfasade
max_depth(heltal, standardvärde3). Fältet har nu ingen effekt och har inte längre några minimi- eller maxbegränsningar. - Metadata för crawlningsjobb kräver inte längre
max_depth.
- Utfasade
Användare
- Hämta användare och Hämta prenumeration
- Valutauppräkningar lägger till
gbp.
- Valutauppräkningar lägger till
Schemaändringar
Text to Speech
- WebSocket-meddelanden för
audioochfinalmed flera kontexter definierar nuis_final_audio_for_turnsom att den inträffar efter att alla buffrade byte för turen har levererats.
ElevenAgents
- Samtalskö och vänteljud: Lade till samtalskö för agenter som nått sin samtidighetsgräns. Uppringare i kö hör vänteljud och får
queue_status-händelser tills de släpps in eller tiden går ut. Nya API-metoder laddar upp eller tar bort anpassat vänteljud. - Metadata för testversioner: Agenttestresultat identifierar nu vilken agentversion de kördes mot och om de inkluderade utkaständringar. Anropssammanfattningar anger även när partiella återinskick kördes mot olika versioner.
- Modell- och kontometadata: Agenters LLM-konfiguration accepterar nu
gemini-3.8-flash. WhatsApp-kontosvar identifierar om kontot använder Cloud API eller registreringsflödet för samexistens.
Musik
- Stöd för Music v2.5 API: Musikändpunkter och SDK:er accepterar nu
music_v2_5. Delar för generering av kompositionsplaner har stöd för upp till 6 132 tecken, med upp till 30 rader på 200 tecken vardera.
SDK-versioner
JavaScript SDK
- v2.68.0 - Lade till metoder för att ladda upp och ta bort vänteljud för agenter. Återskapade typer för samtalskö, procedurreferenser, skapande av utkastgrenar, RAG-frågegränser, metadata för testversioner,
gemini-3.8-flashochmusic_v2_5.
Python SDK
- v2.68.0 - Lade till synkrona och asynkrona metoder för att ladda upp och ta bort vänteljud för agenter. Återskapade typer för samtalskö, procedurer, skapande av utkastgrenar, RAG-frågegränser, metadata för testversioner,
gemini-3.8-flashochmusic_v2_5. Omslagetcompose_detailedaccepterar nu alla genererade musikmodell-ID:n samt både prompt- och delbaserade kompositionsplaner.
iOS SDK
- v3.3.1 - Matchar agentmeddelanden med
response_idi stället förevent_id, vilket bevarar flera svar kring verktygsanrop och förhindrar att streamade delar eller korrigeringar kopplas till fel meddelande.
ElevenLabs CLI
- v1.3.0 - Lade till valfri
--intent-metadata för genererade API-kommandon. Lade tillelevenlabs feedback missing-capabilityför att rapportera arbetsflöden som CLI:t inte stöder.
Paket
- @elevenlabs/convai-widget-core@0.18.2 och @elevenlabs/convai-widget-embed@0.18.2 - Åtgärdade dubbla agentsvar efter verktygs- och proceduranrop. Streamade textsvar behåller Markdown-formatering, och röstsamtal visar inte längre outtalade streamade chattdelar. Embed-paketet begränsar även
user_activity-händelser till en gång per sekund och återställer gränsen när en session avslutas.
API
Visa API-ändringar
Nya ändpunkter
ElevenAgents
- Ladda upp vänteljud för agent -
POST /v1/convai/agents/{agent_id}/hold-audio- Accepterar obligatoriska
hold_audio_file(binär) som multipart-formulärdata. Filen måste vara MP3 eller WAV, upp till 40 MB och 180 sekunder. - Returnerar obligatoriska
agent_id(sträng) ochhold_audio(AgentHoldAudioConfig). Vänteljudsobjektet kräveraudio_path,audio_url,original_filename(strängar),duration_secs(tal) ochsize_bytes(heltal).
- Accepterar obligatoriska
- Ta bort vänteljud för agent -
DELETE /v1/convai/agents/{agent_id}/hold-audio- Tar bort det anpassade klippet så att uppringare i kö hör standardtonen för vänteläge.
- Returnerar obligatoriska
agent_id(sträng).
Uppdaterade ändpunkter
ElevenAgents
- Skapa agent, Hämta agent och Uppdatera agent
- Lade till valfri
platform_settings.queueing_config(AgentQueueingConfig) medenabled(boolesk, standardvärdefalse) ochwait_timeout_seconds(heltal, 1–1 800, standardvärde180). - Svar för kökonfiguration inkluderar skrivskyddade nullable
hold_audio(AgentHoldAudioConfig). Agentsvar inkluderar även valfriadefault_hold_audio_url(sträng).
- Lade till valfri
- Hämta konversation -
GET /v1/convai/conversations/{conversation_id}- Metadata lägger till valfria nullable
queue_wait_secs(tal). Kötid exkluderas fråncall_duration_secsoch fakturerad tid.
- Metadata lägger till valfria nullable
- Skapa agentgren -
POST /v1/convai/agents/{agent_id}/branches- Lade till valfria
include_draft(boolesk, standardvärdefalse). När värdet ärtrueinkluderar en gren som skapats från grentoppen anroparens uppsättning utkastprocedurer.
- Lade till valfria
- Lista procedurer samt ändpunkter för att skapa, hämta och utkast för procedurer
- Listobjekt lägger till valfria
referenced_tool_ids,referenced_kb_ids,referenced_procedure_idsochreferenced_dynamic_variables(strängarrayer). - Svar för agenter och förhandsvisningar av sammanslagningar lägger till valfria
procedures, en karta med procedur-ID som nyckel.
- Listobjekt lägger till valfria
- Lista testanrop -
GET /v1/convai/test-invocations- Lade till valfria nullable
search(sträng) för att filtrera tester och mappar efter namn.
- Lade till valfria nullable
- Kör tester på agent och Hämta testanrop
- Svar för testsvitsanrop och enhetstestkörningar lägger till valfria nullable
version_id(sträng) och valfriaran_against_draft(boolesk, standardvärdefalse). - Anropssammanfattningar lägger även till valfria
runs_diverged_from_version(boolesk, standardvärdefalse).
- Svar för testsvitsanrop och enhetstestkörningar lägger till valfria nullable
POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query- Begärandetexten lägger till valfria nullable frågespecifika åsidosättningar för
max_documents_length(heltal, 1–50 000) ochmax_retrieved_rag_chunks_count(heltal, 1–20).
- Begärandetexten lägger till valfria nullable frågespecifika åsidosättningar för
- Hämta WhatsApp-konto -
GET /v1/convai/whatsapp-accounts/{phone_number_id}- Lade till valfria
account_type(WhatsAppAccountType, standardvärdecloud_api). Värden ärcloud_apiochcoexistence.
- Lade till valfria
- Beräkna förväntad LLM-användning -
POST /v1/convai/agent/{agent_id}/llm-usage/calculateLLMUsageCalculatorLLMResponseModellägger till obligatoriskaprice_per_message(tal).
Musik
MusicModelIDlägger tillmusic_v2_5förPOST /v1/music/video-to-music,POST /v1/music/plan, Komponera musik,POST /v1/music/detailed,POST /v1/music/detailed/stream,POST /v1/music/stream,POST /v1/music/uploadochPOST /v1/music/finetunes.GenerationChunk.textökarmaxLengthfrån 6 000 till 6 132 tecken förPOST /v1/music/plan,POST /v1/music,POST /v1/music/detailed,POST /v1/music/detailed/stream,POST /v1/music/streamochPOST /v1/music/upload. Avsnittsnamn kan innehålla 1–100 tecken och delar kan innehålla upp till 30 rader med 200 tecken per rad.
Schemaändringar
ElevenAgents
- Serverhändelser i realtid lägger till
queue_status. Dess obligatoriskaqueue_status_event.statusaccepterarwaiting,admittedellertimed_out;timed_outföregår WebSocket-stängningskod4300. Vänteljud fortsätter att komma som vanligaaudio-händelser. - Uppräkningen
LLMlägger tillgemini-3.8-flash, inklusive åsidosättningar för konversationsinitiering. - Unioner för resultat från systemverktyg i konversationer lägger till
start_procedure_success,start_procedure_error,end_procedure_successochend_procedure_error. FeaturesUsageCommonModellägger till valfria funktionsstatusar förfreeform_procedureochstructured_procedure.
Scribe v2 Medical
Scribe v2 Medical är nu allmänt tillgänglig. Det är en batchmodell för taligenkänning som är specialiserad på medicinskt och kliniskt ljud och kostar lika mycket som Scribe v2.
Skicka scribe_v2_medical som model_id i Skapa transkript. Promptning med nyckeltermer, entitetsidentifiering, talardiarisering och läget utan ordagrann återgivning fungerar på samma sätt som i Scribe v2.
ElevenAgents
- Samtalsärenden för hela arbetsytan: Lade till Lista arbetsytans ärenden för att hämta samtalstriageärenden för tillgängliga agenter. Filtrera efter status eller ansvarig och använd markörpaginering för att hämta upp till 100 ärenden per sida.
- Samtalsfilter för dynamiska variabler: Lista samtal och Textsök i samtalsmeddelanden accepterar nu upprepningsbara filter
dynamic_variable_params. Användname:op:valuemedeq,gt,gte,ltellerlte; jämförelseoperatorer kräver numeriska värden. - Twilio-detektering av telefonsvarare: Konfigurationer för utgående telefoni och batchsamtal har nu stöd för valfria
twilio_machine_detection. Väljenableför ett tidigt avgörande om människa eller maskin, ellerdetect_message_endför att vänta tills hälsningen i röstbrevlådan är klar. Resultaten levereras via den nya webhook-händelsenanswering_machine_detection. - Värdebegränsningar för datainsamling: Egenskaper för datainsamling kan nu använda
allowed_valuesför att namnge en dynamisk variabel som innehåller tillåtna värden. Det tidigare fältetallowed_values_dynamic_variableär inaktuellt. - Agentmetadata: Svar från Lista agentgrenar visar nu när ett utkast skapades och om det ligger efter grenens senaste version. Sammanfattningar för agenter och talmotorer kräver nu
voice_id. - Käll-URL:er för kunskapsbasen: Agentens RAG-frågebitar innehåller nu obligatoriska nullbara
source_url, som innehåller den spårade URL:en för URL-dokument. - Bilagor i agentsvar: WebSocket-händelser för
agent_responseinnehåller nu valfriaattachments. Varje bilaga kräverurlochnameoch kan innehållamime_type.
Arbetsytor
- Plattformsgränser för API-nycklar: Svar för API-nycklar till tjänstkonton kan nu inkludera företagsnivåns
platform_limitsför krediter, Professional Voice Clones samt samtidighet för TTS, dubbning och musik.
SDK-versioner
JavaScript SDK
- v2.67.0 - Lade till
dynamicVariableParamsi begäranden för samtalslistning och textsökning. Genererade om typer för Twilio-detektering av telefonsvarare, värdebegränsningar för datainsamling, plattformsgränser för API-nycklar, utkastmetadata för agentgrenar och käll-URL:er för kunskapsbasen.
Python SDK
- v2.67.0 - Lade till
dynamic_variable_paramsi synkrona och asynkrona metoder för samtalslistning och textsökning. Genererade om typer för Twilio-detektering av telefonsvarare, värdebegränsningar för datainsamling, plattformsgränser för API-nycklar, utkastmetadata för agentgrenar och käll-URL:er för kunskapsbasen. Klienten för text-till-tal i realtid skickar inte längre den interna utelämningssentineln till anslutningen.
ElevenLabs CLI
- v1.2.0 - Lade till kommandot
elevenlabs sayoch dess agentfärdighet, genererade om API-kommandobindningar och gjordeeleven_v3till standardmodellen för TTS.
Paket
- @elevenlabs/client@1.25.0, @elevenlabs/react@1.15.2, @elevenlabs/react-native@1.2.27, @elevenlabs/convai-widget-core@0.18.1 och @elevenlabs/convai-widget-embed@0.18.1 - Återexporterade
MessageAttachmentfrån@elevenlabs/clientså att användare kan importera typen direkt. - @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 och @elevenlabs/convai-widget-embed@0.18.0 - Vidarebefordrade filbilagor i agentsvar till
onMessageoch lade till den valfria sessionsinställningenwebRtc.singlePeerConnection. Widgeten lokaliserar också hälsningsknappar och åtgärdar bortfallna eller dubblerade textsvar i chatten.
API
Visa API-ändringar
Nya slutpunkter
ElevenAgents
- Lista arbetsytans ärenden -
GET /v1/convai/triage-tickets- Listar samtalstriageärenden för alla agenter som anroparen har åtkomst till, sorterade med de senast skapade först.
- Lade till valfria frågeparametrar
page_size(heltal, 1–100, standard100),status(AgentConversationTicketStatus),assignee_user_id(sträng ellerunassigned) ochcursor(sträng). - Returnerar
GetAgentConversationTicketsPageResponseModel.
Uppdaterade slutpunkter
ElevenAgents
- Lista samtal -
GET /v1/convai/conversations- Lade till valfria nullbara
dynamic_variable_params(upprepningsbar strängmatris). Varje värde användername:op:value, däropäreq,gt,gte,ltellerlte.
- Lade till valfria nullbara
- Textsök i samtalsmeddelanden -
GET /v1/convai/conversations/messages/text-search- Lade till valfria nullbara
dynamic_variable_params(upprepningsbar strängmatris) med samma syntax.
- Lade till valfria nullbara
- Utgående Twilio-samtal, Utgående SIP-trunksamtal, Utgående Exotel-samtal och Skicka batchuppringning
telephony_call_configanvänder nu separata in- och utmatningsscheman.- Lade till valfria nullbara
twilio_machine_detection(TwilioMachineDetectionConfig). Dessmodeaccepterarenableellerdetect_message_endoch har standardvärdetenable. Inställningen ignoreras för andra leverantörer än Twilio och för inkommande samtal.
- Importera telefonnummer -
POST /v1/convai/phone-numbers- Lade till valfria nullbara
account_auth_token(sträng) för importer av Twilio API-nycklar för att validera signaturer för inkommande webhooks.
- Lade till valfria nullbara
Schemaändringar
ElevenAgents
WebhookEventTypelägger tillanswering_machine_detection.AgentBranchSummarylägger till valfria nullbaradraft_created_at(heltal) och valfriadraft_is_behind_tip(boolean, standardfalse).AgentKnowledgeBaseRagChunkResponseModellägger till obligatoriska nullbarasource_url(sträng).AgentSummaryResponseModelochSpeechEngineSummaryResponselägger till obligatoriskavoice_id(sträng).AnalysisPropertylägger till valfria nullbaraname(sträng) ochallowed_values(AllowedValues).LiteralJsonSchemaPropertylägger också tillallowed_values. Båda markerarallowed_values_dynamic_variablesom inaktuellt.DataCollectionResultCommonModellägger till valfria nullbaraname(sträng).WorkspaceApiKeyResponseModellägger till valfria nullbaraplatform_limits(PlatformLimits).- MCP-verktyget
Iconlägger till valfria nullbaratheme(lightellerdark). SMBToolConfiglägger till parametervarianternasend_custom_email,create_service_quote_requestochcreate_product_quote_request.- Scheman för webhook-frågeparametrar och konfiguration för telefonsamtal använder nu separata in- och utmatningsmodeller.
- WebSocket-händelser för
agent_responselägger till valfriaattachments(matris). Varje objekt kräverurlochname(strängar) och accepterar valfriamime_type(sträng).
ElevenCreative
ReferenceVideo.studio_clipanvänder nuStudioClipLocatori stället förStudioClipReference. Fälten och wire-formatet är oförändrade.
ElevenAgents
- Telefonknappsatsinmatning: Agentens samtalskonfiguration har nu stöd för valfria
dtmf_input_settingsför DTMF-inmatning. Konfigurera tidsgränsen för siffror, använd#som avslutare och maskera knappsatsinmatningar i transkriptioner, loggar och analyser. - Historik för samtalsbilagor: Transkriptposter från Hämta samtal innehåller nu
file_inputs, en matris med ID, namn, MIME-typ och URL för varje bifogad fil. - Filtrering med agenttaggar: Lista agenter accepterar nu den valfria frågeparametern
tags. Upprepa parametern för att matcha agenter med någon av de angivna taggarna. - Batchkampanjkontext: Hämta samtal identifierar nu batchsamtal med nullbara
campaign-metadata som innehåller obligatoriskacampaign_idochcampaign_lead_id.
Musik
- Visuella vågformsdata: Generera detaljerad musik, Streama musik med detaljer och Ladda upp musik accepterar nu valfria
with_waveform_visual(boolean, standardfalse). Svar där funktionen har aktiverats returnerar en lågupplöst heltalsmatriswaveform_visualmed fyra samplingar per sekund.
Dubbning
- Beteende för projektpaginering: Lista dubbningsprojekt och Lista språkmål begränsar nu
page_sizetill 1–100. Filtrering av projektstatus inkluderarqueued, och båda slutpunkterna dokumenterar hur du användernext_cursorför att hämta nästa sida.
SDK-versioner
JavaScript SDK
- v2.66.0 - Lade till
fileIdsisendMultimodalMessage, så att ett meddelande kan innehålla flera filbilagor.
Python SDK
- v2.66.0 - Lade till
file_idsisend_multimodal_message, så att ett meddelande kan innehålla flera filbilagor.
Android SDK
- v0.12.2 - Bevarade callbacken
onUnhandledClientToolCallvid koppling av sessionshändelser. Ohanterade klientverktygsanrop som förväntar sig ett svar får nu det automatiska felsvaret i stället för att förbli olösta.
ElevenLabs CLI
- v1.1.0 - Genererade om API-kommandobindningar och lade till begärandeattribuering per kommando för ElevenAgents-workflows. Dessa kommandon lägger till
cmd/<command>i CLI:nsUser-Agent, så att begäranden från workflows somagents pushochagents createkan särskiljas.
Paket
- @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 och @elevenlabs/convai-widget-embed@0.17.1 - Lade till
fileIdsisendMultimodalMessage. Klienten skickar både fältenfileochfilesför kompatibilitet, och React exponerar det uppdaterade klient-API:t.
API
Visa API-ändringar
Uppdaterade slutpunkter
ElevenAgents
- Lista agenter -
GET /v1/convai/agents- Lade till valfria nullbara
tags(strängmatris). Upprepa frågeparametern för att matcha en angiven tagg.
- Lade till valfria nullbara
- Skapa agent, Hämta agent och Uppdatera agent
- Lade till valfria nullbara
conversation_config.conversation.dtmf_input_settings(DTMFInputConfig). Den har stöd fördtmf_input_timeout(nummer, 0.5–10 sekunder, standard2),hash_terminator(boolean, standardtrue) ochredact_input(boolean, standardfalse). - Lade till valfria
sip_refer_play_dialtone(boolean, standardtrue) i konfigurationen för överföring av telefonnummer. Angefalseför att behålla det ursprungliga samtalsbenet tyst medan en SIP REFER-överföring slutförs. - Systemverktyg för start- och slutprocedurer accepterar nu antingen en
ProcedureVersionRefeller enProcedureDraftRef. Utkastsreferenser kräverprocedure_id(sträng) och angerversion_idtillnull.
- Lade till valfria nullbara
- Hämta samtal -
GET /v1/convai/conversations/{conversation_id}- Lade till
file_inputs(matris medConversationHistoryTranscriptFileInputResponseModel) i transkriptposter. Varje objekt kräverfile_id,original_filename,mime_typeochfile_url(strängar). - Lade till valfria nullbara
campaign(BatchCallingCampaignInformation) i metadata för batchsamtal. Objektet krävercampaign_idochcampaign_lead_id(strängar). - Lade till
dtmfiChatSourceMedium.
- Lade till
- Ärendetyper för samtalstriage har lagt till
incorrect_information,documentation_gap,platform_bugochwrong_action.
Musik
- Generera detaljerad musik (
POST /v1/music/detailed) och Streama musik med detaljer (POST /v1/music/detailed/stream)- Lade till valfria
with_waveform_visual(boolean, standardfalse). - Detaljerade svar lägger till nullbara
waveform_visual(heltalsmatris), samplade fyra gånger per sekund från-1000till1000.
- Lade till valfria
- Ladda upp musik -
POST /v1/music/upload- Lade till valfria
with_waveform_visual(boolean, standardfalse) och nullbarawaveform_visual(heltalsmatris) i svaret.
- Lade till valfria
ElevenCreative
- Skapa Studio-projekt och Skapa podcast
quality_presetaccepterar nunull, och dess schemastandardstandardhar tagits bort.
Dubbning
- Lista dubbningsprojekt -
GET /v1/dubbing/projectpage_sizeär fortfarande ett valfritt heltal med standardvärdet20, men värden begränsas nu till 1–100 i stället för att avvisas.- Filtret
statusdokumenterar nuqueued,preparing,readyochfailed. - Skicka föregående svars
next_cursoricursor; utelämna den för första sidan.
- Lista språkmål -
GET /v1/dubbing/project/{project_id}/languagepage_sizeär fortfarande ett valfritt heltal med standardvärdet20, men värden begränsas nu till 1–100 i stället för att avvisas.- Filtret
statushar stöd förqueued,processing,completed,staleochfailed. - Skicka föregående svars
next_cursoricursor; utelämna den för första sidan.
Schemaändringar
Arbetsyta
PendingSubscriptionSwitchResponseModel.next_tierlägger tillgrant.