변경 로그

April 20, 2026

개발자 리소스

  • ElevenLabs Devs YouTube 채널: 튜토리얼, API 안내 및 기술 심층 분석을 제공하여 ElevenLabs 플랫폼을 최대한 활용할 수 있도록 돕는 새로운 개발자 중심 YouTube 채널이 공개되었습니다.

ElevenAgents

  • 워크플로 시작 노드 재정의: 이제 대화 시작 클라이언트 데이터에 starting_workflow_node_id를 전달하여 특정 워크플로 노드에서 대화를 시작할 수 있습니다. 이는 에이전트의 플랫폼 재정의 설정에 있는 옵트인 enable_starting_workflow_node_id_from_client 필드로 제어됩니다. 활성화하면 클라이언트가 대화를 시작할 노드를 지정할 수 있으며, 이는 에이전트 메모리 및 장기적인 WebSocket 사용 사례에 유용합니다. 지정된 노드가 없으면 대화는 기본 진입점으로 돌아갑니다.

  • 통화 후 분석 LLM 구성: 이제 에이전트 플랫폼 설정에는 평가 기준과 데이터 수집을 포함한 통화 후 분석의 기본 LLM을 설정하는 analysis_llm 필드(기본값: gemini-2.5-flash)가 포함됩니다. 개별 데이터 수집 속성은 새로운 AnalysisProperty 스키마를 통해 항목별 llm 필드로 이 기본값을 재정의할 수 있어, 각 분석 항목을 처리할 모델을 세밀하게 제어할 수 있습니다.

  • 새 LLM 옵션: 에이전트 구성에 사용할 수 있는 LLM 제공업체 목록에 gpt-5.4를 추가했습니다. 지원되는 모델에서 확장 추론을 위한 xhigh를 LLMReasoningEffort 열거형에 추가했습니다.

  • 워크플로 표현식의 null 리터럴: 이제 워크플로 조건부 표현식은 새로운 ASTNullNode 유형을 통한 null 비교를 지원하여, 워크플로 로직에서 “변수가 null인 경우”와 같은 분기를 사용할 수 있습니다.

  • ID로 시크릿 가져오기: 새로운 시크릿 가져오기 엔드포인트(GET /v1/convai/secrets/{secret_id})는 ID로 단일 워크스페이스 시크릿을 조회합니다. 이제 시크릿 목록 엔드포인트도 이름 접두사로 시크릿을 필터링하는 search 쿼리 매개변수를 지원합니다.

  • 일괄 통화의 검색 가능한 전화번호: 이제 대시보드의 일괄 통화 양식에 검색 가능한 전화번호 선택기가 포함되어, 일괄 통화를 구성할 때 적절한 발신 번호를 더 쉽게 찾을 수 있습니다.

음성 텍스트 변환

  • 화자 역할 감지: 이제 음성을 텍스트로 변환 엔드포인트는 detect_speaker_roles 매개변수(불리언, 기본값 false)를 지원합니다. diarize=true와 함께 활성화하면 화자 레이블이 speaker_0, speaker_1 대신 agent 및 customer로 반환됩니다. 이 기능은 use_multi_channel=true와 함께 사용할 수 없습니다. 사용 시 기본 트랜스크립션 비용에 10%의 추가 요금이 부과됩니다.

텍스트 대화 변환

  • 입력 문자 수 제한 안내: 이제 텍스트를 대화로 변환 엔드포인트는 요청당 모든 inputs[].text 값에 걸쳐 2,000자 제한을 권장한다고 안내합니다. 더 긴 요청은 스트리밍 응답에서 일찍 종료되거나 유효성 검사 오류를 반환할 수 있습니다.

워크스페이스

  • 사용량 분석 엔드포인트: 새로운 시간별 제품 사용량 엔드포인트(POST /v1/workspace/analytics/query/usage-by-product-over-time)는 시간 경과에 따른 제품 유형별 크레딧 사용량을 반환합니다. 결과는 구성 가능한 interval_seconds, group_by 차원 및 filters를 포함하는 표 형식으로 반환됩니다. 이전 GET /v1/usage/character-stats 엔드포인트는 이 새 엔드포인트로 대체되어 지원 중단되었습니다.

SDK 릴리스

패키지

API

새 엔드포인트

  • 시크릿 가져오기 - GET /v1/convai/secrets/{secret_id}
  • POST /v1/workspace/analytics/query/usage-by-product-over-time - 시간별 워크스페이스 제품 크레딧 사용량 가져오기

지원 중단된 엔드포인트

  • GET /v1/usage/character-stats - POST /v1/workspace/analytics/query/usage-by-product-over-time로 대체되어 지원 중단됨
  • 모든 더빙 리소스 편집 엔드포인트(POST /v1/dubbing/resource/{dubbing_id}/language, POST /v1/dubbing/resource/{dubbing_id}/speaker/{speaker_id}/segment, PATCH /v1/dubbing/resource/{dubbing_id}/segment/{segment_id}/{language} 등)는 이제 지원 중단되었습니다.

업데이트된 엔드포인트

ElevenAgents

  • 에이전트 생성, 에이전트 가져오기, 에이전트 업데이트

    • 기본 통화 후 분석 모델을 구성하기 위해 AgentPlatformSettings에 analysis_llm 필드(LLM 열거형, 기본값: gemini-2.5-flash)를 추가했습니다.
    • 이제 데이터 수집 속성은 선택적 항목별 llm 재정의 필드가 있는 AnalysisProperty 스키마를 사용합니다.

  • 대화 시뮬레이션

    • 대화 시작 클라이언트 데이터에 starting_workflow_node_id 필드(문자열, null 허용)를 추가했습니다.
    • ConversationInitiationClientDataConfig에 enable_starting_workflow_node_id_from_client 필드(불리언, 기본값 false)를 추가했습니다.

  • 일괄 통화 제출

    • 일괄 통화 레코드에 external_link 필드(문자열, null 허용)를 추가했습니다.

  • 시크릿 목록

    • 이름 접두사로 시크릿을 필터링하는 선택적 search 쿼리 매개변수(문자열)를 추가했습니다.

  • LLM 열거형

    • gpt-5.4, gpt-5.4-2026-03-05를 추가했습니다.

  • LLMReasoningEffort 열거형

    • xhigh를 추가했습니다.

  • 워크플로 표현식(ASTNode)

    • null 비교를 위한 null_literal 판별자 값 및 ASTNullNode 스키마를 추가했습니다.

  • 배열 도구 매개변수(ArrayJsonSchemaProperty)

    • 런타임에 동적 변수로 배열을 채우는 dynamic_variable 필드(문자열, 선택 사항)를 추가했습니다.
    • 상수 배열 값을 설정하는 constant_value 필드(배열, null 허용)를 추가했습니다.
    • 이제 items 필드는 필수가 아닙니다(기본 스키마 제공).

  • MCP 도구 구성 재정의

    • 이제 응답은 MCPToolConfigOverride-Output 스키마(입력/출력 분리)를 사용합니다.

음성 텍스트 변환

  • 음성을 텍스트로 변환

    • 에이전트/고객 화자 역할 감지를 위한 detect_speaker_roles 필드(불리언, 기본값 false)를 추가했습니다.

텍스트 대화 변환

텍스트 음성 변환

  • 이제 TTS 및 대화 엔드포인트의 품질 프리셋 필드는 QualityPresetType 열거형 스키마를 참조합니다. 대화 품질 프리셋에서 highest 값은 제거되었으므로 대신 ultra를 사용하세요.

기타

  • AudioNativeResponse - 응답에서 transcription 필드를 제거했습니다.
  • UserResponseModel - 이전 버전과 호환되는 스키마 업데이트