Spraakengine maken

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

Maak een nieuwe Speech Engine-resource

Request

This endpoint expects an object.

speech_engineobjectRequired

WebSocket-configuratie van de spraakengine

namestringOptionalDefaults to Speech Engine

Naam van de spraakengine

asrobjectOptional

ASR-configuratie

ttsobjectOptional

TTS-configuratie

turnobjectOptional

Configuratie voor beurtendetectie

vadobjectOptional

Configuratie voor stemactiviteitsdetectie

conversationobjectOptional

Gespreksconfiguratie (clientevents enz.)

privacyobjectOptional

Privacyinstellingen (opname, bewaartermijn, modus zonder gegevensbewaring)

call_limitsobjectOptional

Gelijktijdigheids- en dagelijkse gesprekslimieten voor deze spraakengine

languagestringOptionalDefaults to en

Taal voor de spraakengine

cascade_timeout_secondsdoubleOptional2-15Defaults to 4

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 stringsOptional

Tags voor categorisatie

overridesobjectOptional

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

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

Headers

Request

Response

Errors