> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Uppdatera talmotor

PATCH https://api.elevenlabs.io/v1/speech-engine/{speech_engine_id}
Content-Type: application/json

Uppdatera en Speech Engine-resurs (partiell uppdatering)

Reference: https://elevenlabs.io/docs/api-reference/speech-engine/update

## Servers

- `https://api.elevenlabs.io` (Production, default)
- `https://api.us.elevenlabs.io` (Production US)
- `https://api.eu.residency.elevenlabs.io` (Production EU)
- `https://api.in.residency.elevenlabs.io` (Production India)
- `https://api.sg.residency.elevenlabs.io` (Production Singapore)

## Request

### Path parameters

- `speech_engine_id` (string, required) — Talengine-ID:t (accepterar prefixet seng_ eller agent_)

### Body (application/json)

This endpoint expects an UpdateSpeechEngineRequest.

- `name` (string, optional, nullable)
- `speech_engine` (SpeechEngineConfig, optional, nullable)
- `asr` (ASRConversationalConfig, optional, nullable)
- `tts` (TTSConversationalConfig-Input, optional, nullable)
- `turn` (BaseTurnConfig, optional, nullable)
- `vad` (VADConfig, optional, nullable)
- `conversation` (ConversationConfig-Input, optional, nullable)
- `privacy` (PrivacyConfig-Input, optional, nullable)
- `call_limits` (AgentCallLimits, optional, nullable)
- `language` (string, optional, nullable)
- `cascade_timeout_seconds` (double, optional, nullable) — Tid i sekunder att vänta på svar från den överordnade slutpunkten för talmotorn innan försöket avbryts och görs om. Måste vara mellan 2 och 15 sekunder.
- `tags` (list of string, optional, nullable)
- `overrides` (SpeechEngineConversationInitiationClientDataConfig, optional, nullable)

## Response

### 200

Lyckat svar

- `speech_engine_id` (string, required) — Talengineresurs-ID:t
- `name` (string, required) — Människoläsbart namn för talmotorn
- `speech_engine` (SpeechEngineConfig, required) — WebSocket-anslutningsinställningar för den uppströms transkriptservern
- `asr` (ASRConversationalConfig, required) — Konfiguration för automatisk taligenkänning
- `tts` (TTSConversationalConfig-Output, required) — Konfiguration för Text to Speech-utdata
- `turn` (BaseTurnConfig, required) — Konfiguration för turdetektering
- `vad` (VADConfig, required) — Konfiguration för röstaktivitetsdetektering
- `conversation` (ConversationConfig-Output, required) — Inställningar på konversationsnivå, inklusive klienthändelser och tidsgränser
- `privacy` (PrivacyConfig-Output, required) — Sekretessinställningar som styr inspelning, lagring och hantering av PII
- `call_limits` (AgentCallLimits, required) — Gränser för samtidighet och dagliga samtal för denna talmotor
- `language` (string, required) — ISO-språkkod som används av talsyntesmotoren (t.ex. ”en”)
- `cascade_timeout_seconds` (double, required) — Tid i sekunder att vänta på svar från den överordnade slutpunkten för talmotorn innan försöket avbryts och görs om. Måste vara mellan 2 och 15 sekunder.
- `tags` (list of string, required) — Valfria taggar för kategorisering och filtrering
- `overrides` (SpeechEngineConversationInitiationClientDataConfig, required) — Åsidosättningsinställningar som klienten kan ange när konversationen startas
- `metadata` (AgentMetadataDBModel, required) — Tidsstämplar för skapande och uppdatering med källinformation
- `access_info` (ResourceAccessInfo, optional, nullable) — Talmodellens åtkomstinformation för användaren

## Errors

### 422 Unprocessable Entity Error

Valideringsfel

- `detail` (list of ValidationError, optional)

## Types

### SpeechEngineConfig

- `ws_url` (string, required) — WebSocket-URL:en för transkriptservern
- `request_headers` (map from string to SpeechEngineConfigRequestHeaders, optional) — Headers att inkludera i begäran om WebSocket-anslutning

### ASRConversationalConfig

- `quality` (enum, optional, default: high) — Transkriberingens kvalitet
  - Allowed values: `high`
- `provider` (enum, optional, default: scribe_realtime) — Leverantören av transkriberingstjänsten
  - Allowed values: `elevenlabs`, `scribe_realtime`, `scribe_v2_turbo`
- `user_input_audio_format` (enum, optional, default: pcm_16000) — Formatet på ljudet som ska transkriberas
  - Allowed values: `pcm_8000`, `pcm_16000`, `pcm_22050`, `pcm_24000`, `pcm_44100`, `pcm_48000`, `ulaw_8000`
- `keywords` (list of string, optional) — Nyckelord att öka förutsägelsesannolikheten för

### TTSConversationalConfig-Input

- `model_id` (enum, optional, default: eleven_v4_turbo) — Modellen som ska användas för TTS
  - Allowed values: `eleven_turbo_v2`, `eleven_turbo_v2_5`, `eleven_flash_v2`, `eleven_flash_v2_5`, `eleven_multilingual_v2`, `eleven_v3_conversational`, `eleven_v4`, `eleven_v4_turbo`
- `voice_id` (string, optional, default: cjVigY5qzO86Huf0OWal) — Röst-ID:t som ska användas för TTS
- `supported_voices` (list of SupportedVoice, optional) — Ytterligare röster som stöds för agenten
- `expressive_mode` (boolean, optional, default: true) — När funktionen är aktiverad tillämpas prompten för uttrycksfulla ljudtaggar. Inaktiveras automatiskt för modeller som inte är v3.
- `suggested_audio_tags` (list of SuggestedAudioTag, optional) — Föreslagna ljudtaggar för mer uttrycksfullt tal (för modellerna eleven_v3 och eleven_v3_conversational). Agenten kan fortfarande använda andra taggar som inte listas här.
- `agent_output_audio_format` (enum, optional, default: pcm_16000) — Ljudformatet som ska användas för TTS
  - Allowed values: `pcm_8000`, `pcm_16000`, `pcm_22050`, `pcm_24000`, `pcm_44100`, `pcm_48000`, `ulaw_8000`
- `stability` (double, optional, default: 0.5) — Stabiliteten hos genererat tal
- `speed` (double, optional, default: 1) — Hastigheten på genererat tal
- `similarity_boost` (double, optional, default: 0.8) — Likhetsförstärkningen för genererat tal
- `text_normalisation_type` (enum, optional, default: system_prompt) — Metod för att omvandla siffror till ord innan text omvandlas till tal. Om värdet är SYSTEM_PROMPT uppdateras systemprompten med normaliseringsinstruktioner. Om värdet är ELEVENLABS normaliseras texten efter generering, vilket ger något högre latens.
  - Allowed values: `system_prompt`, `elevenlabs`
- `pronunciation_dictionary_locators` (list of PydanticPronunciationDictionaryVersionLocator, optional) — Uttalsordbokens lokaliserare
- `enable_phoneme_tags` (boolean, optional, default: true) — Välj att aktivera hantering av SSML-fonemtaggar för V3-modeller. När den är aktiverad tolkas fonemtaggar, både infogade och från uttalslexikon, till infogad IPA innan de skickas till modellen.
- `audio_effects` (EffectsSpec-Input, optional, nullable) — Valfri specifikation för TTS-effekter: filterförinställning, avstånd (närhets-EQ) och miljö (konvolutionsreverb).
- `optimize_streaming_latency` (enum, optional, deprecated) — Föråldrat: det här fältet har ingen effekt och ignoreras.
  - Allowed values: `0`, `1`, `2`, `3`, `4`

### BaseTurnConfig

- `turn_timeout` (double, optional, default: 7) — Maximal väntetid på användarens svar innan användaren kontaktas igen
- `initial_wait_time` (double, optional, nullable) — Hur länge agenten väntar på att användaren ska starta samtalet om det första meddelandet är tomt. Om det inte anges används det vanliga turn_timeout.
- `silence_end_call_timeout` (double, optional, default: -1) — Maximal tid sedan användaren senast talade innan samtalet avslutas
- `turn_eagerness` (enum, optional, default: normal) — Styr hur snabbt agenten svarar. Low = mindre ivrig (väntar längre), Standard = standardnivå, High = mer ivrig (svarar snabbare)
  - Allowed values: `patient`, `normal`, `eager`
- `spelling_patience` (enum, optional, default: auto) — Styr om agenten ska vara mer tålmodig när användaren bokstaverar siffror och namngivna entiteter. Auto = modellbaserat, Off = vänta aldrig extra
  - Allowed values: `auto`, `off`
- `speculative_turn` (boolean, optional, default: false) — När funktionen är aktiverad börjar den generera LLM-svar under tystnad innan full säkerhet om turskiftet har uppnåtts, vilket minskar den upplevda fördröjningen. Kan öka LLM-kostnaderna.
- `retranscribe_on_turn_timeout` (boolean, optional, default: false) — När funktionen är aktiverad försöker den transkribera ackumulerat ljud på nytt vid turens tidsgräns om VAD inte upptäcker något tal. Inaktiverar rabatterad debitering för tystnad medan den är aktiverad för den aktiva agenten eller arbetsflödesnoden.
- `turn_model` (enum, optional, default: turn_v3) — Version av turdetekteringsmodellen som ska användas.
  - Allowed values: `turn_v2`, `turn_v3`
- `interruption_ignore_terms` (list of string, optional) — Lista över termer som inte ska utlösa ett avbrott när användaren säger dem (t.ex. ”jag förstår”, ”uppfattat”). Använder exakt matchning utan hänsyn till versaler och gemener.
- `interruption_ignore_term_languages` (list of string, optional) — Språkkoder för vilka förinställda kategorier av ignoreringstermer har aktiverats. Sparas uttryckligen så att visningen inte härleds från överlappande termer.
- `merge_with_default_ignore_terms` (boolean, optional, default: false) — När funktionen är aktiverad används de utvalda standardtermerna för interruption_ignore_term_languages utöver interruption_ignore_terms.
- `transcribe_on_disabled_interruptions` (boolean, optional, default: false) — När avbrott är inaktiverade ska det användaren säger ändå transkriberas så att det kan följa med till nästa tur. När funktionen är avstängd ignoreras användartal under en tur som inte kan avbrytas och utlöser ingen tur.

### VADConfig

### ConversationConfig-Input

- `text_only` (boolean, optional, default: false) — Om den är aktiverad bearbetas inte ljudet och endast text används. Använd detta för att undvika ljudprissättning.
- `max_duration_seconds` (integer, optional, default: 600) — En konversations maximala längd i sekunder
- `client_events` (list of enum, optional) — Händelserna som skickas till klienten
  - Allowed values: `conversation_initiation_metadata`, `asr_initiation_metadata`, `ping`, `audio`, `interruption`, `user_transcript`, `tentative_user_transcript`, `agent_response`, `agent_response_correction`, `client_tool_call`, `mcp_tool_call`, `mcp_connection_status`, `agent_tool_request`, `agent_tool_response`, `agent_tool_response_full_payload`, `agent_response_metadata`, `vad_score`, `agent_chat_response_part`, `client_error`, `guardrail_triggered`, `dtmf_request`, `agent_response_complete`, `context_usage`, `internal_turn_probability`, `internal_tentative_agent_response`
- `file_input` (FileInputConfig, optional) — Konfiguration för filinmatning (bild-/PDF-uppladdningar) under samtal.
- `monitoring_enabled` (boolean, optional, default: false) — Aktivera övervakning av samtal i realtid via WebSocket
- `monitoring_events` (list of enum, optional) — Händelserna som skickas till övervakningsanslutningar.
  - Allowed values: `conversation_initiation_metadata`, `asr_initiation_metadata`, `ping`, `audio`, `interruption`, `user_transcript`, `tentative_user_transcript`, `agent_response`, `agent_response_correction`, `client_tool_call`, `mcp_tool_call`, `mcp_connection_status`, `agent_tool_request`, `agent_tool_response`, `agent_tool_response_full_payload`, `agent_response_metadata`, `vad_score`, `agent_chat_response_part`, `client_error`, `guardrail_triggered`, `dtmf_request`, `agent_response_complete`, `context_usage`, `internal_turn_probability`, `internal_tentative_agent_response`
- `dtmf_input_settings` (DTMFInputConfig, optional, nullable) — Konfigurera insamling av DTMF-inmatning (knappsats) under telefonsamtal
- `background_sound` (BackgroundSoundConfig, optional) — Konfiguration för bakgrundsljud under samtal.
- `source_attribution` (boolean, optional, default: false) — När funktionen är aktiverad och innehåll i kunskapsbasen finns instrueras LLM:et att rapportera vilka källor det använde.

### PrivacyConfig-Input

- `record_voice` (boolean, optional, default: true) — Om samtalet ska spelas in
- `retention_days` (integer, optional, default: -1) — Antalet dagar som konversationen ska behållas. -1 anger att det inte finns någon lagringsgräns.
- `delete_transcript_and_pii` (boolean, optional, default: false) — Om transkriptionen och PII ska tas bort
- `delete_audio` (boolean, optional, default: false) — Om ljudet ska tas bort
- `apply_to_existing_conversations` (boolean, optional, default: false) — Om sekretessinställningarna ska tillämpas på befintliga samtal
- `zero_retention_mode` (boolean, optional, default: false) — Om nollagringsläget ska aktiveras – inga PII-data lagras
- `conversation_history_redaction` (ConversationHistoryRedactionConfig, optional) — Konfiguration för maskering av PII i samtalshistoriken

### AgentCallLimits

- `agent_concurrency_limit` (integer, optional, default: -1) — Det högsta antalet samtidiga konversationer. -1 anger att det inte finns någon gräns.
- `daily_limit` (integer, optional, default: 100000) — Det högsta antalet konversationer per dag
- `bursting_enabled` (boolean, optional, default: true) — Om bursting ska aktiveras. Om true tillåts arbetsytans samtidighetsgräns överskridas med upp till tre gånger gränsen. Anrop debiteras till dubbel taxa när gränsen överskrids.

### SpeechEngineConversationInitiationClientDataConfig

- `first_message` (boolean, optional, default: false) — Om det första meddelandet kan åsidosättas av klienten

### TTSConversationalConfig-Output

- `model_id` (enum, optional, default: eleven_v4_turbo) — Modellen som ska användas för TTS
  - Allowed values: `eleven_turbo_v2`, `eleven_turbo_v2_5`, `eleven_flash_v2`, `eleven_flash_v2_5`, `eleven_multilingual_v2`, `eleven_v3_conversational`, `eleven_v4`, `eleven_v4_turbo`
- `voice_id` (string, optional, default: cjVigY5qzO86Huf0OWal) — Röst-ID:t som ska användas för TTS
- `supported_voices` (list of SupportedVoice, optional) — Ytterligare röster som stöds för agenten
- `expressive_mode` (boolean, optional, default: true) — När funktionen är aktiverad tillämpas prompten för uttrycksfulla ljudtaggar. Inaktiveras automatiskt för modeller som inte är v3.
- `suggested_audio_tags` (list of SuggestedAudioTag, optional) — Föreslagna ljudtaggar för mer uttrycksfullt tal (för modellerna eleven_v3 och eleven_v3_conversational). Agenten kan fortfarande använda andra taggar som inte listas här.
- `agent_output_audio_format` (enum, optional, default: pcm_16000) — Ljudformatet som ska användas för TTS
  - Allowed values: `pcm_8000`, `pcm_16000`, `pcm_22050`, `pcm_24000`, `pcm_44100`, `pcm_48000`, `ulaw_8000`
- `stability` (double, optional, default: 0.5) — Stabiliteten hos genererat tal
- `speed` (double, optional, default: 1) — Hastigheten på genererat tal
- `similarity_boost` (double, optional, default: 0.8) — Likhetsförstärkningen för genererat tal
- `text_normalisation_type` (enum, optional, default: system_prompt) — Metod för att omvandla siffror till ord innan text omvandlas till tal. Om värdet är SYSTEM_PROMPT uppdateras systemprompten med normaliseringsinstruktioner. Om värdet är ELEVENLABS normaliseras texten efter generering, vilket ger något högre latens.
  - Allowed values: `system_prompt`, `elevenlabs`
- `pronunciation_dictionary_locators` (list of PydanticPronunciationDictionaryVersionLocator, optional) — Uttalsordbokens lokaliserare
- `enable_phoneme_tags` (boolean, optional, default: true) — Välj att aktivera hantering av SSML-fonemtaggar för V3-modeller. När den är aktiverad tolkas fonemtaggar, både infogade och från uttalslexikon, till infogad IPA innan de skickas till modellen.
- `audio_effects` (EffectsSpec-Output, optional, nullable) — Valfri specifikation för TTS-effekter: filterförinställning, avstånd (närhets-EQ) och miljö (konvolutionsreverb).
- `optimize_streaming_latency` (enum, optional, deprecated) — Föråldrat: det här fältet har ingen effekt och ignoreras.
  - Allowed values: `0`, `1`, `2`, `3`, `4`

### ConversationConfig-Output

- `text_only` (boolean, optional, default: false) — Om den är aktiverad bearbetas inte ljudet och endast text används. Använd detta för att undvika ljudprissättning.
- `max_duration_seconds` (integer, optional, default: 600) — En konversations maximala längd i sekunder
- `client_events` (list of enum, optional) — Händelserna som skickas till klienten
  - Allowed values: `conversation_initiation_metadata`, `asr_initiation_metadata`, `ping`, `audio`, `interruption`, `user_transcript`, `tentative_user_transcript`, `agent_response`, `agent_response_correction`, `client_tool_call`, `mcp_tool_call`, `mcp_connection_status`, `agent_tool_request`, `agent_tool_response`, `agent_tool_response_full_payload`, `agent_response_metadata`, `vad_score`, `agent_chat_response_part`, `client_error`, `guardrail_triggered`, `dtmf_request`, `agent_response_complete`, `context_usage`, `internal_turn_probability`, `internal_tentative_agent_response`
- `file_input` (FileInputConfig, optional) — Konfiguration för filinmatning (bild-/PDF-uppladdningar) under samtal.
- `monitoring_enabled` (boolean, optional, default: false) — Aktivera övervakning av samtal i realtid via WebSocket
- `monitoring_events` (list of enum, optional) — Händelserna som skickas till övervakningsanslutningar.
  - Allowed values: `conversation_initiation_metadata`, `asr_initiation_metadata`, `ping`, `audio`, `interruption`, `user_transcript`, `tentative_user_transcript`, `agent_response`, `agent_response_correction`, `client_tool_call`, `mcp_tool_call`, `mcp_connection_status`, `agent_tool_request`, `agent_tool_response`, `agent_tool_response_full_payload`, `agent_response_metadata`, `vad_score`, `agent_chat_response_part`, `client_error`, `guardrail_triggered`, `dtmf_request`, `agent_response_complete`, `context_usage`, `internal_turn_probability`, `internal_tentative_agent_response`
- `dtmf_input_settings` (DTMFInputConfig, optional, nullable) — Konfigurera insamling av DTMF-inmatning (knappsats) under telefonsamtal
- `background_sound` (BackgroundSoundConfig, optional) — Konfiguration för bakgrundsljud under samtal.
- `source_attribution` (boolean, optional, default: false) — När funktionen är aktiverad och innehåll i kunskapsbasen finns instrueras LLM:et att rapportera vilka källor det använde.

### PrivacyConfig-Output

- `record_voice` (boolean, optional, default: true) — Om samtalet ska spelas in
- `retention_days` (integer, optional, default: -1) — Antalet dagar som konversationen ska behållas. -1 anger att det inte finns någon lagringsgräns.
- `delete_transcript_and_pii` (boolean, optional, default: false) — Om transkriptionen och PII ska tas bort
- `delete_audio` (boolean, optional, default: false) — Om ljudet ska tas bort
- `apply_to_existing_conversations` (boolean, optional, default: false) — Om sekretessinställningarna ska tillämpas på befintliga samtal
- `zero_retention_mode` (boolean, optional, default: false) — Om nollagringsläget ska aktiveras – inga PII-data lagras
- `conversation_history_redaction` (ConversationHistoryRedactionConfig, optional) — Konfiguration för maskering av PII i samtalshistoriken

### AgentMetadataDBModel

- `created_at_unix_secs` (integer, required)
- `updated_at_unix_secs` (integer, required)
- `created_from` (enum, optional, default: unknown)
  - Allowed values: `cli`, `ui`, `api`, `template`, `unknown`
- `last_updated_from` (enum, optional, default: unknown)
  - Allowed values: `cli`, `ui`, `api`, `template`, `unknown`

### ResourceAccessInfo

- `is_creator` (boolean, required) — Om användaren som gör begäran är agentens skapare
- `creator_name` (string, required) — Namn på agentens skapare
- `creator_email` (string, required) — E-postadress till agentens skapare
- `role` (enum, required) — Rollen för användaren som gör begäran
  - Allowed values: `admin`, `editor`, `commenter`, `viewer`
- `anonymous_access_level_override` (enum, optional, nullable) — Åtkomstnivån för anonyma användare. Om värdet är None delas resursen inte offentligt.
  - Allowed values: `admin`, `editor`, `commenter`, `viewer`
- `access_source` (enum, optional, nullable) — Varför den begärande användaren har åtkomst till den här resursen. 'creator' = anroparen är ägaren. 'explicit' = anroparen (eller en av deras arbetsytas grupper) finns listad i role_to_group_ids utöver den arbetsyteomfattande gruppen för alla. 'workspace_default' = den arbetsyteomfattande gruppen för alla finns listad i role_to_group_ids (alla icke-anonyma medlemmar i arbetsytan, inklusive administratörer, ser den här resursen). 'workspace_admin' = anroparen är administratör för arbetsytan och administratörsplatsen är den *enda* åtkomstvägen; reserverad för dokument som ingen annan kan se. Gör det möjligt för användargränssnittet att förklara varför en administratör som kringgår behörigheter ser ett dokument som inte uttryckligen har delats med dem.
  - Allowed values: `creator`, `explicit`, `workspace_admin`, `workspace_default`

### ValidationError

- `loc` (list of ValidationErrorLocItems, required)
- `msg` (string, required)
- `type` (string, required)

### SpeechEngineConfigRequestHeaders

### SupportedVoice

- `label` (string, required)
- `voice_id` (string, required)
- `description` (string, optional, nullable)
- `language` (string, optional, nullable)
- `model_family` (enum, optional, nullable)
  - Allowed values: `turbo`, `flash`, `multilingual`, `v3_conversational`, `v4`, `v4_turbo`
- `optimize_streaming_latency` (enum, optional, nullable)
  - Allowed values: `0`, `1`, `2`, `3`, `4`
- `stability` (double, optional, nullable)
- `speed` (double, optional, nullable)
- `similarity_boost` (double, optional, nullable)

### SuggestedAudioTag

- `tag` (string, required) — Ljudtagg att använda (för bästa prestanda, 1–2 ord, t.ex. ”happy”, ”excited”)
- `description` (string, optional, nullable) — Valfri beskrivning av när denna tagg ska användas

### PydanticPronunciationDictionaryVersionLocator

En pekare så att andra dokument kan referera till ett specifikt lexikon och dess version. Det här är en pydantic-version av PronunciationDictionaryVersionLocatorDBModel. Krävs för kompatibilitet med övriga datamodeller för agenter.

- `pronunciation_dictionary_id` (string, required) — ID:t för uttalsordlistan
- `version_id` (string, required, nullable) — ID:t för versionen av uttalsordlistan

### EffectsSpec-Input

Filtrera förinställning, avstånd (närhets-EQ) och miljö (konvolutionsreverb).

- `filter_preset_id` (string, optional, nullable)
- `distance` (double, optional, default: 0)
- `environment_id` (string, optional, nullable)
- `background_noise_id` (string, optional, nullable)
- `send_level` (double, optional, default: 1)
- `seed` (integer, optional, nullable)

### FileInputConfig

- `enabled` (boolean, optional, default: true) — När funktionen är aktiverad kan användare bifoga bilder eller PDF:er i chatten när LLM:et stöder multimodal indata.
- `max_files_in_memory` (integer, optional, default: 10) — Antal senast använda filer som behålls i minnet under en konversation. Äldre filer sammanfattas och deras byte frigörs.
- `max_files_per_conversation` (integer, optional, default: 10) — Totalt antal filer som en användare kan ladda upp i ett samtal. Uppladdningar debiteras per fil. Använd -1 för ingen gräns eller ett värde >= max_files_in_memory.

### DTMFInputConfig

Konfiguration för insamling av DTMF-inmatning (knappsats) under telefonsamtal.

- `dtmf_input_timeout` (double, optional, default: 2) — Timeout i sekunder för att vänta på ytterligare DTMF-siffror
- `hash_terminator` (boolean, optional, default: true) — Om värdet är true slutförs DTMF-inmatningen omedelbart när du trycker på #
- `redact_input` (boolean, optional, default: false) — Om värdet är true ersätts uppringarens DTMF-inmatningar (knappsats) med en maskeringsmarkör i transkriptionen, samtalsloggen och analysen. Siffror som agenten upprepar eller skickar till ett verktyg påverkas inte.

### BackgroundSoundConfig

- `source_type` (enum, optional, nullable) — Typen av bakgrundsljudkälla.
  - Allowed values: `preset`
- `source_id` (enum, optional, nullable) — Identifierare för ljudkällan.
  - Allowed values: `office2`, `office1`, `restaurant`, `city`, `typing`, `elevator1`, `elevator2`, `elevator3`, `elevator4`
- `volume` (double, optional, default: 0.15) — Volymnivå för bakgrundsljud (0.01 till 1.0).
- `crossfade_loop` (boolean, optional, default: true) — Använd en crossfade vid loopgränsen för att undvika hörbara knäppningar när ljudet loopas.

### ConversationHistoryRedactionConfig

- `enabled` (boolean, optional, default: false) — Om maskering av konversationshistorik är aktiverad
- `entities` (list of enum, optional) — Entiteterna som ska maskeras i konversationens transkription, ljud och analys. Använd typer på toppnivå som 'name', 'email_address' eller punktnotation för specifika undertyper som 'name.full_name'.
  - Allowed values: `name`, `name.name_given`, `name.name_family`, `name.name_other`, `email_address`, `contact_number`, `dob`, `age`, `religious_belief`, `political_opinion`, `sexual_orientation`, `ethnicity_race`, `marital_status`, `occupation`, `physical_attribute`, `language`, `username`, `password`, `url`, `organization`, `financial_id`, `financial_id.payment_card`, `financial_id.payment_card.payment_card_number`, `financial_id.payment_card.payment_card_expiration_date`, `financial_id.payment_card.payment_card_cvv`, `financial_id.bank_account`, `financial_id.bank_account.bank_account_number`, `financial_id.bank_account.bank_routing_number`, `financial_id.bank_account.swift_bic_code`, `financial_id.financial_id_other`, `location`, `location.location_address`, `location.location_city`, `location.location_postal_code`, `location.location_coordinate`, `location.location_state`, `location.location_country`, `location.location_other`, `date`, `date_interval`, `unique_id`, `unique_id.government_issued_id`, `unique_id.account_number`, `unique_id.vehicle_id`, `unique_id.healthcare_number`, `unique_id.healthcare_number.medical_record_number`, `unique_id.healthcare_number.health_plan_beneficiary_number`, `unique_id.device_id`, `unique_id.unique_id_other`, `medical`, `medical.medical_condition`, `medical.medication`, `medical.medical_procedure`, `medical.medical_measurement`, `medical.medical_other`
- `excluded_data_collection_ids` (list of string, optional) — ID:n för datainsamlingsobjekt vars extraherade värden inte maskeras. Deras motiveringar maskeras fortfarande.

### EffectsSpec-Output

Filtrera förinställning, avstånd (närhets-EQ) och miljö (konvolutionsreverb).

- `filter_preset_id` (string, required, nullable)
- `distance` (double, required, default: 0)
- `environment_id` (string, required, nullable)
- `background_noise_id` (string, required, nullable)
- `send_level` (double, required, default: 1)
- `seed` (integer, required, nullable)

### ValidationErrorLocItems

### ConvAISecretLocator

Används för att referera till en hemlighet från agentens hemlighetslager.

- `secret_id` (string, required)

### ConvAIDynamicVariable

Används för att referera till en dynamisk variabel.

- `variable_name` (string, required)

## Examples

**Request**

```json
{}
```

**Response**

```json
{
  "speech_engine_id": "seng_3701k3ttaq12ewp8b7qv5rfyszkz",
  "name": "My Speech Engine",
  "speech_engine": {
    "ws_url": "wss://example.com/transcript",
    "request_headers": {}
  },
  "asr": {
    "quality": "high",
    "provider": "elevenlabs",
    "user_input_audio_format": "pcm_16000",
    "keywords": []
  },
  "tts": {
    "model_id": "eleven_flash_v2",
    "voice_id": "cjVigY5qzO86Huf0OWal",
    "agent_output_audio_format": "pcm_16000",
    "stability": 0.5,
    "speed": 1,
    "similarity_boost": 0.8,
    "optimize_streaming_latency": 3
  },
  "turn": {
    "turn_timeout": 7,
    "silence_end_call_timeout": -1,
    "turn_eagerness": "normal",
    "mode": "turn"
  },
  "vad": {
    "background_voice_detection": false
  },
  "conversation": {
    "max_duration_seconds": 600,
    "client_events": [
      "audio",
      "interruption",
      "agent_response",
      "user_transcript"
    ]
  },
  "privacy": {
    "record_voice": true,
    "retention_days": -1,
    "delete_transcript_and_pii": false,
    "delete_audio": false,
    "apply_to_existing_conversations": false,
    "zero_retention_mode": false
  },
  "call_limits": {
    "agent_concurrency_limit": -1,
    "daily_limit": 100000,
    "bursting_enabled": true
  },
  "language": "en",
  "cascade_timeout_seconds": 4,
  "tags": [
    "production",
    "v1"
  ],
  "overrides": {
    "first_message": false
  },
  "metadata": {
    "created_at_unix_secs": 1714000000,
    "updated_at_unix_secs": 1714000000,
    "created_from": "api",
    "last_updated_from": "api"
  }
}
```

**SDK Code**

```python
import requests

url = "https://api.elevenlabs.io/v1/speech-engine/seng_3701k3ttaq12ewp8b7qv5rfyszkz"

payload = {}
headers = {"Content-Type": "application/json"}

response = requests.patch(url, json=payload, headers=headers)

print(response.json())
```

```javascript
const url = 'https://api.elevenlabs.io/v1/speech-engine/seng_3701k3ttaq12ewp8b7qv5rfyszkz';
const options = {method: 'PATCH', headers: {'Content-Type': 'application/json'}, body: '{}'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.elevenlabs.io/v1/speech-engine/seng_3701k3ttaq12ewp8b7qv5rfyszkz"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.elevenlabs.io/v1/speech-engine/seng_3701k3ttaq12ewp8b7qv5rfyszkz")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Content-Type"] = 'application/json'
request.body = "{}"

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.patch("https://api.elevenlabs.io/v1/speech-engine/seng_3701k3ttaq12ewp8b7qv5rfyszkz")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('PATCH', 'https://api.elevenlabs.io/v1/speech-engine/seng_3701k3ttaq12ewp8b7qv5rfyszkz', [
  'body' => '{}',
  'headers' => [
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.elevenlabs.io/v1/speech-engine/seng_3701k3ttaq12ewp8b7qv5rfyszkz");
var request = new RestRequest(Method.PATCH);
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = ["Content-Type": "application/json"]
let parameters = [] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.elevenlabs.io/v1/speech-engine/seng_3701k3ttaq12ewp8b7qv5rfyszkz")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "PATCH"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```