Speech Engine bijwerken

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

Werk een Speech Engine-resource bij (gedeeltelijke update)

Path parameters

speech_engine_idstringRequired

De ID van de spraakengine (accepteert het voorvoegsel seng_ of agent_)

Request

This endpoint expects an object.

namestring or nullOptional

speech_engineobject or nullOptional

asrobject or nullOptional

ttsobject or nullOptional

turnobject or nullOptional

vadobject or nullOptional

conversationobject or nullOptional

privacyobject or nullOptional

call_limitsobject or nullOptional

languagestring or nullOptional

cascade_timeout_secondsdouble or nullOptional2-15

Tijd in seconden om te wachten op een reactie van het upstream speech engine-endpoint voordat de poging wordt afgebroken en opnieuw geprobeerd. Moet tussen 2 en 15 seconden liggen.

tagslist of strings or nullOptional

overridesobject or nullOptional

Response

Geslaagde response

speech_engine_idstring

De resource-ID van de spraakengine

namestring

Voor mensen leesbare naam voor de Speech Engine

speech_engineobject

WebSocket-verbindingsinstellingen voor de upstream-transcriptserver

asrobject

Configuratie voor automatische spraakherkenning

ttsobject

Configuratie voor uitvoer van Text to Speech

turnobject

Configuratie voor beurtendetectie

vadobject

Configuratie voor stemactiviteitsdetectie

conversationobject

Instellingen op gespreksniveau, waaronder clientevents en tijdslimieten

privacyobject

Privacyinstellingen voor opname, bewaartermijn en verwerking van PII

call_limitsobject

Gelijktijdigheids- en dagelijkse gesprekslimieten voor deze spraakengine

languagestring

ISO-taalcode die wordt gebruikt door de spraakengine (bijvoorbeeld ‘en’)

cascade_timeout_secondsdouble

Tijd in seconden om te wachten op een reactie van het upstream speech engine-endpoint voordat de poging wordt afgebroken en opnieuw geprobeerd. Moet tussen 2 en 15 seconden liggen.

tagslist of strings

Willekeurige tags voor categorisering en filtering

overridesobject

Instellingen die de client kan overschrijven bij het starten van een gesprek

metadataobject

Tijdstempels voor maken en bijwerken met broninformatie

access_infoobject or nullOptional

De toegangsgegevens van de spraakengine voor de gebruiker

Errors

422

Unprocessable Entity Error

Path parameters

Headers

Request

Response

Errors