Speech Engine erstellen

POST

/v1/speech-engine

POST

/v1/speech-engine

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

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

Erstellen Sie eine neue Speech-Engine-Ressource.

Anfrage

This endpoint expects an object.

speech_engineobjectErforderlich

WebSocket-Konfiguration der Speech Engine

namestringOptionalStandardwert ist Speech Engine

Name der Sprach-Engine

asrobjectOptional

ASR-Konfiguration

ttsobjectOptional

TTS-Konfiguration

turnobjectOptional

Konfiguration der Sprecherwechselerkennung

vadobjectOptional

Konfiguration für Sprachaktivitätserkennung

conversationobjectOptional

Gesprächskonfiguration (Client-Ereignisse usw.)

privacyobjectOptional

Datenschutzeinstellungen (Aufzeichnung, Aufbewahrung, Zero-Retention-Modus)

call_limitsobjectOptional

Gleichzeitigkeits- und tägliche Unterhaltungslimits für diese Sprach-Engine

languagestringOptionalStandardwert ist en

Sprache für die Sprach-Engine

cascade_timeout_secondsdoubleOptional2-15Standardwert ist 4

Zeit in Sekunden, die auf eine Antwort des vorgeschalteten Speech-Engine-Endpunkts gewartet wird, bevor der Versuch abgebrochen und wiederholt wird. Muss zwischen 2 und 15 Sekunden liegen.

tagslist of stringsOptional

Tags zur Kategorisierung

overridesobjectOptional

Einstellungen überschreiben, die der Client beim Starten der Unterhaltung festlegen kann

Antwort

Erfolgreiche Antwort

speech_engine_idstring

Die Ressourcen-ID der Speech Engine

namestring

Menschenlesbarer Name für die Speech Engine

speech_engineobject

WebSocket-Verbindungseinstellungen für den vorgelagerten Transkriptserver

asrobject

Konfiguration der automatischen Spracherkennung

ttsobject

Ausgabekonfiguration für Text to Speech

turnobject

Konfiguration der Sprecherwechselerkennung

vadobject

Konfiguration für Sprachaktivitätserkennung

conversationobject

Einstellungen auf Gesprächsebene, einschließlich Client-Ereignissen und Dauerlimits

privacyobject

Datenschutzeinstellungen für Aufzeichnung, Aufbewahrung und den Umgang mit personenbezogenen Daten

call_limitsobject

Gleichzeitigkeits- und tägliche Unterhaltungslimits für diese Sprach-Engine

languagestring

Von der Sprach-Engine verwendeter ISO-Sprachcode (z. B. ‘en’)

cascade_timeout_secondsdouble

Zeit in Sekunden, die auf eine Antwort des vorgeschalteten Speech-Engine-Endpunkts gewartet wird, bevor der Versuch abgebrochen und wiederholt wird. Muss zwischen 2 und 15 Sekunden liegen.

tagslist of strings

Beliebige Tags zur Kategorisierung und Filterung

overridesobject

Einstellungen überschreiben, die der Client beim Starten der Unterhaltung festlegen kann

metadataobject

Zeitstempel für Erstellung und Aktualisierung mit Quellinformationen

access_infoobject or nullOptional

Die Zugriffsinformationen der Sprach-Engine für den Nutzer

Fehler

422

Unprocessable Entity Error

Header

Anfrage

Antwort

Fehler