변경 로그

July 28, 2025

워크스페이스

  • 서비스 계정 API 키 관리: 생성, 조회, 업데이트, 삭제 기능을 포함하여 서비스 계정 API 키를 관리할 수 있는 포괄적인 API 엔드포인트를 추가했습니다. 서비스 계정 문서를 참조하세요.

에이전트 플랫폼

  • 통화 후 웹훅 마이그레이션: SDK에서 웹훅 핸들러를 자동 생성할 수 있도록 통화 후 웹훅 형식을 마이그레이션하고 있습니다. 이는 호환성이 깨지는 변경 사항이 아니며, 현재 핸들러가 추가 필드를 허용한다면 별도의 조치는 필요하지 않습니다. 자세한 내용은 여기를 참조하세요.
  • 에이전트 전환 개선: 에이전트 간 전환 후 system_agent_id가 올바르게 업데이트되도록 수정하여 정확한 대화 컨텍스트 추적을 보장합니다. 현재 활성 에이전트를 추적하는 새 system_current_agent_id 변수를 추가했습니다. 동적 변수에 대해 자세히 알아보세요.
  • 향상된 공개 에이전트 페이지: 공개 에이전트 대화 페이지에 텍스트 입력 기능 및 동적 변수 지원을 추가했습니다. 이제 URL 파라미터(예: ?var_username=value)를 통해 동적 변수를 전달하고, 음성 대화 중 텍스트 입력을 사용할 수 있습니다. 동적 변수 가이드를 참조하세요.
  • 음성사서함 감지: 통화 처리를 개선하기 위해 ElevenLabs 에이전트의 기본 제공 도구로 음성사서함 감지를 추가했습니다. 음성사서함 감지에 대해 알아보세요.
  • 대화 필터링: 대화를 시작한 사용자별로 대화를 필터링할 수 있도록 대화 목록 엔드포인트에 user_id 쿼리 파라미터를 추가했습니다.

음성 텍스트 변환

  • 다중 채널 트랜스크립션: 별도 채널에 여러 화자가 있는 오디오 파일을 처리할 수 있도록 트랜스크립션 엔드포인트에 use_multi_channel 파라미터를 추가했습니다. 채널별 트랜스크립션 결과를 포함해 최대 5개 채널을 지원합니다. 멀티채널 가이드를 참조하세요.

ElevenCreative 스튜디오

  • 캡션 지원: 팟캐스트와 일반 프로젝트 모두에 새 captions_enabled 및 caption_style 속성을 추가하여 ElevenCreative 스튜디오 프로젝트에 캡션 기능을 지원합니다. ElevenCreative 스튜디오에 대해 자세히 알아보세요.

SDK

API 스키마 업데이트

새 엔드포인트

  • 서비스 계정 관리: 서비스 계정 API 키 관리를 위한 새 엔드포인트 5개를 추가했습니다.
    • GET /v1/service-accounts/{service_account_user_id}/api-keys - 서비스 계정 API 키 조회
    • POST /v1/service-accounts/{service_account_user_id}/api-keys - 서비스 계정 API 키 생성
    • DELETE /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id} - 서비스 계정 API 키 삭제
    • PATCH /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id} - 서비스 계정 API 키 업데이트
    • GET /v1/service-accounts - 워크스페이스 서비스 계정 가져오기

제거된 엔드포인트

  • 레거시 프로젝트 엔드포인트: ElevenCreative 스튜디오 API 통합의 일환으로 지원이 중단된 프로젝트 관리 엔드포인트 22개를 제거했습니다.
    • 모든 /v1/projects/* 엔드포인트(/v1/studio/projects/*로 대체)
    • 레거시 텍스트 음성 변환 엔드포인트(/v1/text-to-voice/create-voice-from-preview, /v1/text-to-voice/remixing-sessions/*)
    • 레거시 ConvAI 지식 베이스 엔드포인트

업데이트된 엔드포인트

음성 텍스트 변환

  • 다중 채널 지원: /v1/speech-to-text 엔드포인트를 업데이트했습니다.
    • 다중 화자 오디오 파일 처리를 위한 use_multi_channel 파라미터 추가
    • 선택적 language_code, language_probability, text, words 속성을 포함하도록 응답 구조 수정

에이전트 플랫폼

  • 향상된 에이전트 구성: 에이전트 생성 및 관리 엔드포인트를 업데이트했습니다.
    • 기본 제공 도구에 음성사서함 감지 추가
    • max_retrieved_rag_chunks_count 파라미터로 RAG 구성 개선
    • source 및 version 파라미터로 대화 토큰 엔드포인트 개선
    • 대화 목록 엔드포인트에 user_id 필터링 추가

ElevenCreative 스튜디오 프로젝트

  • 캡션 지원: ElevenCreative 스튜디오 프로젝트 엔드포인트를 다음과 같이 업데이트했습니다.
    • 캡션 활성화/비활성화를 위한 captions_enabled 속성
    • 전역 캡션 스타일 구성용 caption_style 속성

텍스트 음성 변환

  • 개선된 보이스 생성: 보이스 생성 엔드포인트를 다음과 같이 개선했습니다.
    • loudness 제어(-1~1 범위, 0은 -24 LUFS에 해당)
    • 출력 품질과 다양성 간 균형을 위한 quality 파라미터
    • AI 창의성과 프롬프트 준수 간 균형을 제어하는 guidance_scale 파라미터