음성 엔진 생성

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

새 Speech Engine 리소스를 생성합니다.

요청

This endpoint expects an object.

speech_engineobject필수

음성 엔진 WebSocket 구성

namestring선택 사항기본값 Speech Engine

음성 엔진 이름

asrobject선택 사항

ASR 구성

ttsobject선택 사항

TTS 구성

turnobject선택 사항

턴 감지 구성

vadobject선택 사항

음성 활동 감지 구성

conversationobject선택 사항

대화 구성(클라이언트 이벤트 등)

privacyobject선택 사항

개인정보 설정(녹음, 보존, 무보존 모드)

call_limitsobject선택 사항

이 음성 엔진의 동시 실행 및 일일 대화 제한

languagestring선택 사항기본값 en

음성 엔진 언어

cascade_timeout_secondsdouble선택 사항2-15기본값 4

시도를 중단하고 재시도하기 전에 업스트림 음성 엔진 엔드포인트의 응답을 기다리는 시간(초)입니다. 2~15초 사이여야 합니다.

tagslist of strings선택 사항

분류용 태그

overridesobject선택 사항

대화 시작 중 클라이언트가 설정할 수 있는 재정의 설정입니다.

응답

성공 응답

speech_engine_idstring

음성 엔진 리소스 ID

namestring

음성 엔진의 사람이 읽을 수 있는 이름

speech_engineobject

업스트림 트랜스크립트 서버의 WebSocket 연결 설정

asrobject

자동 음성 인식 구성

ttsobject

텍스트 음성 변환 출력 구성

turnobject

턴 감지 구성

vadobject

음성 활동 감지 구성

conversationobject

클라이언트 이벤트 및 기간 제한을 포함한 대화 수준 설정

privacyobject

녹음, 보존 및 PII 처리를 제어하는 개인정보 설정

call_limitsobject

이 음성 엔진의 동시 실행 및 일일 대화 제한

languagestring

음성 엔진에서 사용하는 ISO 언어 코드(예: ‘en’)

cascade_timeout_secondsdouble

시도를 중단하고 재시도하기 전에 업스트림 음성 엔진 엔드포인트의 응답을 기다리는 시간(초)입니다. 2~15초 사이여야 합니다.

tagslist of strings

분류 및 필터링을 위한 임의의 태그

overridesobject

대화 시작 중 클라이언트가 설정할 수 있는 재정의 설정입니다.

metadataobject

소스 정보를 포함한 생성 및 업데이트 타임스탬프

access_infoobject or null선택 사항

사용자의 음성 엔진 액세스 정보

오류

422

Unprocessable Entity Error

헤더

요청

응답

오류