Aggiorna motore di sintesi vocale

PATCH

/v1/speech-engine/:speech_engine_id

PATCH

/v1/speech-engine/:speech_engine_id

curl -X PATCH https://api.elevenlabs.io/v1/speech-engine/seng_3701k3ttaq12ewp8b7qv5rfyszkz \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "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"
  }
}

Aggiorna una risorsa Speech Engine (aggiornamento parziale)

Parametri di percorso

speech_engine_idstringObbligatorio

L'ID del motore vocale, accetta il prefisso seng_ o agent_

Richiesta

This endpoint expects an object.

namestring or nullOpzionale

speech_engineobject or nullOpzionale

asrobject or nullOpzionale

ttsobject or nullOpzionale

turnobject or nullOpzionale

vadobject or nullOpzionale

conversationobject or nullOpzionale

privacyobject or nullOpzionale

call_limitsobject or nullOpzionale

languagestring or nullOpzionale

cascade_timeout_secondsdouble or nullOpzionale2-15

Tempo in secondi di attesa della risposta dell'endpoint del motore vocale upstream prima di abbandonare e ripetere il tentativo. Deve essere compreso tra 2 e 15 secondi.

tagslist of strings or nullOpzionale

overridesobject or nullOpzionale

Risposta

Risposta riuscita

speech_engine_idstring

L'ID della risorsa del motore vocale

namestring

Nome leggibile del motore vocale

speech_engineobject

Impostazioni della connessione WebSocket per il server di trascrizione upstream

asrobject

Configurazione del riconoscimento vocale automatico

ttsobject

Configurazione dell'output Text to Speech

turnobject

Configurazione del rilevamento dei turni

vadobject

Configurazione per il rilevamento dell'attività vocale

conversationobject

Impostazioni a livello di conversazione, inclusi eventi client e limiti di durata

privacyobject

Impostazioni sulla privacy che controllano la registrazione, la conservazione e la gestione delle PII

call_limitsobject

Limiti di concorrenza e di conversazioni giornaliere per questo motore vocale

languagestring

Codice lingua ISO usato dal motore vocale (ad esempio "en")

cascade_timeout_secondsdouble

Tempo in secondi di attesa della risposta dell'endpoint del motore vocale upstream prima di abbandonare e ripetere il tentativo. Deve essere compreso tra 2 e 15 secondi.

tagslist of strings

Tag arbitrari per la categorizzazione e il filtro

overridesobject

Impostazioni di override che il client può impostare durante l'avvio della conversazione

metadataobject

Timestamp di creazione e aggiornamento con informazioni sulla fonte

access_infoobject or nullOpzionale

Le informazioni di accesso del motore vocale per l'utente

Errori

422

Unprocessable Entity Error

Parametri di percorso

Header

Richiesta

Risposta

Errori