변경 로그

새 엔드포인트

• 대화 메시지 텍스트 검색 - GET /v1/convai/conversations/messages/text-search - 대화 내용 메시지에 대해 전문 또는 퍼지 검색 수행
• 대화 메시지 스마트 검색 - GET /v1/convai/conversations/messages/smart-search - 임베딩을 사용해 대화 메시지에 대한 의미 기반 검색 수행
• 사용 가능한 LLM 나열 - GET /v1/convai/llm/list - 지원 종료 정보, 기능 및 컨텍스트 제한이 포함된 사용 가능한 LLM 조회
• 대화에 파일 업로드 - POST /v1/convai/conversations/{conversation_id}/files - 대화 컨텍스트에 파일 업로드
• 대화 파일 삭제 - DELETE /v1/convai/conversations/{conversation_id}/files/{file_id} - 대화에서 업로드된 파일 제거

제거된 엔드포인트

다음 레거시 음성 생성 엔드포인트가 제거되었습니다.

• GET /v1/voice-generation/generate-voice/parameters - 음성 생성 매개변수
• POST /v1/voice-generation/generate-voice - 무작위 음성 생성
• POST /v1/voice-generation/create-voice - 이전에 생성된 음성 생성

대신 보이스 디자인 및 Voice Remix 엔드포인트를 사용하세요.

업데이트된 엔드포인트

ElevenAgents

• 에이전트 생성, 에이전트 업데이트, 에이전트 조회

  • 에이전트 훈련 구성을 위한 coaching_settings 필드를 추가했습니다.
  • 구성 가능한 엔터티 유형과 함께 platform_settings.privacy에 conversation_history_redaction을 추가했습니다.
  • platform_settings.guardrails에 새 가드레일 focus 및 prompt_injection을 추가했습니다.
  • platform_settings.guardrails에서 alignment 가드레일을 제거했습니다.
  • RAG 구성에서 임베딩 모델 옵션으로 qwen3_embedding_4b를 추가했습니다.
  • 범위와 기본값을 더 명확하게 안내하도록 숫자 필드 설명을 업데이트했습니다.

• MCP 서버 생성, MCP 서버 업데이트, MCP 서버 조회

  • OAuth 및 고급 인증 방법을 활성화하는 auth_connection 필드(선택 사항)를 추가했습니다.
  • 이전 버전과의 호환성을 위해 PATCH 엔드포인트에 secret_token 필드를 추가했습니다.
  • 둘 다 제공된 경우 인증 연결이 secret_token보다 우선합니다.

• MCP 도구 구성 생성, MCP 도구 구성 업데이트, MCP 도구 구성 조회

  • 상수, 동적 변수 또는 LLM 생성 값으로 도구 입력 매개변수를 재정의할 수 있는 input_overrides 필드를 추가했습니다.

• RAG 인덱스 생성, RAG 인덱스 삭제

  • embedding_model 열거형에 qwen3_embedding_4b를 추가했습니다.

• 대화 조회

  • search 쿼리 매개변수를 지원 종료했습니다(대신 새 전용 검색 엔드포인트 사용).

• 대화 조회

  • 대화가 숨겨질 수 있는 이유를 나타내는 hiding_reason 필드를 추가했습니다.
  • 새 ChatSourceMedium 유형(오디오, 텍스트, 이미지, 파일)으로 file_input 메타데이터를 지원하도록 대화 내용 항목을 확장했습니다.

• 대화 시뮬레이션, 대화 시뮬레이션 스트림

  • 모든 중첩 구성 필드를 개선된 설명 및 유효성 검사 범위로 업데이트했습니다.

• 에이전트 브랜치 조회, 에이전트 브랜치 업데이트

  • 명확성을 위해 current_live_percentage 필드 설명을 업데이트했습니다.

• ElevenAgents 설정 조회, ElevenAgents 설정 업데이트

  • 개선된 설명으로 rag_retention_period_days 필드를 업데이트했습니다.

워크스페이스

• 웹훅 업데이트

  • 일시적 실패(5xx, 429, 시간 초과)에 대한 자동 재시도를 활성화하는 retry_enabled 필드(불리언, 선택 사항)를 추가했습니다.

• 워크스페이스 리소스 조회, 워크스페이스 리소스 공유, 워크스페이스 리소스 공유 해제

  • 음악 워크스페이스 공유를 지원하도록 resource_type 열거형에 songs를 추가했습니다.

• 사용자 조회

  • workspace_admin, workspace_member, workspace_lite_member 열거형 값을 가진 필수 seat_type 필드를 추가했습니다.

음악

• 음악 생성, 상세 음악 생성, 음악 스트리밍
  • seed 매개변수 설명을 명확히 했습니다. 음악 생성 초기화를 위한 무작위 시드입니다. 동일한 매개변수와 같은 시드를 제공하면 더 일관된 결과를 얻는 데 도움이 되지만, 정확한 재현성은 보장되지 않으며 시스템 업데이트에 따라 출력이 변경될 수 있습니다. prompt 매개변수와 함께 사용할 수 없습니다.

텍스트 음성 변환

• 음성 미리보기 생성, 음성 디자인, 음성 리믹스
  • loudness 매개변수 설명을 업데이트했습니다. 생성된 음성의 볼륨 수준을 제어합니다. -1이 가장 조용하고, 1이 가장 크며, 0은 약 -24 LUFS에 해당합니다.
  • guidance_scale 매개변수 설명을 업데이트했습니다. AI가 프롬프트를 얼마나 밀접하게 따를지 제어합니다. 낮은 숫자는 AI에 창의성을 위한 더 많은 자유를 주고, 높은 숫자는 프롬프트를 더 엄격하게 따르게 합니다. 숫자가 높으면 음성이 부자연스럽거나 로봇처럼 들릴 수 있습니다. 더 길고 자세한 프롬프트는 낮은 guidance scale에서 더 잘 작동합니다.
  • 음성 미리보기 생성용 quality 매개변수 설명을 업데이트했습니다.

음성

• 음성 조회, 음성 설정 조회, 기본 음성 설정 조회, 음성 설정 편집
  • style 매개변수 설명을 업데이트했습니다. 음성의 스타일 과장 정도를 결정합니다. 원본 화자의 스타일을 증폭하려고 시도합니다. 추가 컴퓨팅 리소스를 사용하며 0 이외의 값으로 설정하면 지연 시간이 증가할 수 있습니다.
  • speed 매개변수 설명을 업데이트했습니다. 음성의 속도를 조정합니다. 1.0이 기본값이며, 1.0보다 작은 값은 음성을 느리게 하고 1.0보다 큰 값은 빠르게 합니다.