변경 로그

ElevenAgents, ElevenCreative 및 ElevenAPI

단일 제품으로 인식되던 “ElevenLabs”에서 벗어나, 명확히 정의된 제품군을 갖춘 플랫폼 기반 구조로 전환합니다.

• ElevenAgents(기존 에이전트 플랫폼)
• ElevenCreative(기존 크리에이티브 플랫폼)
• ElevenAPI(신규 개발자 플랫폼)

문서와 SDK README에서 이미 이러한 변경 사항을 확인할 수 있습니다.

글로벌 서버, 베타 종료

이제 글로벌 라우팅이 옵트인 방식이 아닌 기본 설정입니다.

이전에는 기본 ElevenLabs API 서버가 미국에 있었으며, 네덜란드 또는 싱가포르 기반 서버를 통해 트래픽을 라우팅하는 옵트인 베타를 제공했습니다. 이제 글로벌 라우팅이 기본 설정이 되어 지연 시간을 최적화하기 위해 지리적 근접성을 기준으로 서버가 자동 선택됩니다.

옵트인 기본 URL api-global-preview.elevenlabs.io은 이제 더 이상 사용되지 않으므로, 대신 기본 api.elevenlabs.io URL을 사용하세요. SDK를 사용 중이라면 이미 기본 설정으로 적용되어 있습니다.

텍스트 음성 변환

• TTS Normalizer v3.1: 텍스트 정규화기를 버전 3.1로 업그레이드했습니다. 이 버전에는 텍스트 음성 변환의 정확도 향상 및 지연 시간 감소가 포함됩니다.

에이전트 플랫폼

• 맞춤 가드레일: 표준 모더레이션을 넘어 맞춤 콘텐츠 필터링 규칙을 만들 수 있는 사용자 정의 출력 가드레일 지원을 추가했습니다. 이름, 프롬프트 지시문(최대 10,000자), 평가 모델 선택(gemini-2.5-flash-lite 또는 gemini-2.0-flash)으로 가드레일을 구성할 수 있습니다. 가드레일이 트리거되면 대화가 종료됩니다. 구성 세부 정보는 에이전트 생성 API 레퍼런스를 참조하세요.
• WhatsApp 발신 메시지: 메시지 템플릿을 사용해 WhatsApp으로 대화를 시작하는 발신 메시지 전송 엔드포인트(POST /v1/convai/whatsapp/outbound-message)를 추가했습니다. 필수 필드는 whatsapp_phone_number_id, whatsapp_user_id, template_name, template_language_code, template_params, agent_id입니다.
• Eleven v3 대화 모델: 에이전트에서 사용할 수 있는 TTS 모델에 eleven_v3_conversational을 추가하여 에이전트 대화의 음성 품질과 표현력을 개선했습니다.
• 추천 오디오 태그: v3 모델을 사용하는 에이전트의 TTS 구성에 suggested_audio_tags 필드를 추가했습니다. 표현력 있는 음성 생성을 안내하기 위해 최대 20개의 태그(예: “happy”, “excited”)를 정의하고, 각 태그를 사용할 시점에 대한 선택적 설명을 제공할 수 있습니다.
• 도구 오류 처리: 웹훅 도구 구성에 tool_error_handling_mode 필드를 추가했습니다. 옵션은 auto(기본값, 도구 유형에 따라 처리 결정), summarized(LLM 생성 요약 전송), passthrough(원시 오류 전송), hide(에이전트와 오류를 공유하지 않음)입니다.
• 동적 변수 정리: DynamicVariableAssignment에 sanitize 필드(불리언, 기본값 false)를 추가했습니다. 활성화하면 변수 할당을 위해 계속 처리하면서도 할당 값은 도구 응답과 트랜스크립트에서 제거됩니다.
• 턴 모델 선택: 턴 감지 모델 버전을 선택하기 위해 turn_v2 및 turn_v3 옵션이 포함된 TurnModel 열거형을 추가했습니다.
• 워크플로 노드 전송: 워크플로 노드 내 전송을 식별하기 위해 AgentTransfer 스키마에 is_workflow_node_transfer 필드(불리언, 기본값 false)를 추가했습니다.
• 전송 브랜치 메타데이터: 에이전트 전송의 브랜치 라우팅 정보를 추적하기 위해 TransferBranchInfoTrafficSplit 및 TransferBranchInfoDefaultingToMain 스키마를 추가했습니다.
• 워크플로 노드 전환 테스트: 에이전트 워크플로 전환을 검증하기 위해 UnitTestWorkflowNodeTransitionEvaluationNodeId 스키마가 포함된 단위 테스트용 workflow_node_transition 어설션 유형을 추가했습니다.

ElevenCreative Studio

• 음소거 트랙 엔드포인트: 프로젝트에서 음소거된 트랙이 있는 챕터 ID 목록을 반환하는 프로젝트 음소거 트랙 가져오기 엔드포인트(GET /v1/studio/projects/{project_id}/muted-tracks)를 추가했습니다.

워크스페이스

• Lite 멤버 시트 유형: 제한된 액세스 권한을 가진 워크스페이스를 위해 SeatType 열거형에 workspace_lite_member를 추가했습니다.
• 콘텐츠 템플릿 리소스: 워크스페이스 내에서 콘텐츠 템플릿을 공유할 수 있도록 WorkspaceResourceType 열거형에 content_templates를 추가했습니다.

사용자 인터페이스

• 음성 컬렉션 스크롤: macOS의 음성 컬렉션 아이콘 선택기에서 마우스 휠 및 터치 스크롤이 작동하지 않는 문제를 수정했습니다.

SDK 릴리스

Python SDK

• v2.35.0 - 맞춤 가드레일, WhatsApp 발신 메시지, 도구 오류 처리 모드, 동적 변수 정리, 턴 모델 선택 및 Eleven v3 대화 모델 지원을 추가했습니다.

JavaScript SDK

• v2.35.0 - 맞춤 가드레일, WhatsApp 발신 메시지, 도구 오류 처리 모드, 동적 변수 정리, 턴 모델 선택 및 Eleven v3 대화 모델 지원을 추가했습니다.

React 및 Client SDK

• @elevenlabs/react-native@0.5.10 - 텍스트 전용 대화 연결 설정 문제를 수정했습니다.
• @elevenlabs/react@0.14.0 - 에이전트 대화의 지연 시간을 줄이기 위해 오디오 청크 길이를 250ms에서 100ms로 줄였습니다.
• @elevenlabs/client@0.14.0 - 지연 시간을 줄이기 위해 오디오 청크 길이를 250ms에서 100ms로 줄이고, 최상위와 재정의 객체 간 textOnly 옵션 처리를 정규화했습니다.
• @elevenlabs/types@0.5.0 - 오디오 정렬 데이터 지원용 타입을 추가했습니다.

API