ElevenAPIVoices

음성 목록

검색, 필터링 및 페이지네이션을 적용하여 사용자가 사용할 수 있는 모든 음성 목록을 가져옵니다.

헤더

xi-api-keystring선택 사항

쿼리 매개변수

next_page_tokenstring or null선택 사항

페이지네이션에 사용할 다음 페이지 토큰입니다. 이전 요청에서 반환됩니다. 안정적인 페이지네이션을 위해 has_more 플래그와 함께 사용하세요.

page_sizeinteger선택 사항기본값 10

반환할 최대 음성 수입니다. 100을 초과할 수 없으며 기본값은 10입니다. 기본 음성이 포함되므로 페이지 0에는 더 많은 음성이 포함될 수 있습니다.

searchstring or null선택 사항

음성을 필터링할 검색어입니다. 이름, 설명, 라벨, 카테고리에서 검색합니다.

sortstring or null선택 사항

정렬 기준 필드입니다. ‘created_at_unix’ 또는 ‘name’ 중 하나입니다. 이전 음성에서는 ‘created_at_unix’를 사용할 수 없을 수 있습니다.

sort_directionstring or null선택 사항

음성을 정렬할 방향입니다. ‘asc’ 또는 ‘desc’입니다.

voice_typestring or null선택 사항
필터링할 음성 유형입니다. 'personal', 'community', 'default', 'workspace', 'non-default', 'non-community', 'saved' 중 하나입니다. 'non-default'는 'default'를 제외한 모든 유형과 같습니다. 'non-community'는 'personal'과 'workspace'를 합친 것과 같으며(라이브러리 복사본 제외), 'saved'는 non-default와 같지만 컬렉션에 추가된 기본 음성도 포함합니다.
categorystring or null선택 사항

필터링할 음성의 카테고리입니다. ‘premade’, ‘cloned’, ‘generated’, ‘professional’ 중 하나입니다.

fine_tuning_statestring or null선택 사항

필터링할 음성의 파인튜닝 상태입니다. 프로페셔널 음성 복제에만 적용됩니다. ‘draft’, ‘not_verified’, ‘not_started’, ‘queued’, ‘fine_tuning’, ‘fine_tuned’, ‘failed’, ‘delayed’ 중 하나입니다.

collection_idstring or null선택 사항

음성을 필터링할 컬렉션 ID입니다.

genderstring or null선택 사항

음성의 ‘gender’ 라벨을 기준으로 필터링에 사용할 성별입니다.

agestring or null선택 사항

음성의 ‘age’ 라벨을 기준으로 필터링에 사용할 연령입니다.

languagelist of strings or null선택 사항

음성의 ‘language’ 라벨을 기준으로 필터링에 사용할 언어입니다. 지정된 언어 중 하나와 일치하는 음성이 반환됩니다.

accentstring or null선택 사항

음성의 ‘accent’ 라벨을 기준으로 필터링에 사용할 억양입니다.

use_caseslist of strings or null선택 사항

음성의 ‘use_case’ 라벨을 기준으로 필터링하는 데 사용되는 사용 사례입니다. 지정된 사용 사례 중 하나와 일치하는 음성이 반환됩니다.

min_notice_period_daysinteger or null선택 사항

공유 고지 기간이 지정된 일수 이상인 음성으로 필터링합니다.

include_custom_ratesboolean or null선택 사항

사용자 지정 공유 요금이 있는 음성을 포함할지 여부입니다. 기본적으로 포함됩니다.

include_live_moderatedboolean or null선택 사항

실시간 모더레이션이 활성화된 음성을 포함할지 여부입니다. 기본적으로 포함됩니다.

high_qualityboolean or null선택 사항

true인 경우 스튜디오 품질 음성(카테고리가 ‘high_quality’인 음성)만 반환합니다.

include_total_countboolean선택 사항기본값 true
응답에 발견된 음성의 총 개수를 포함할지 여부입니다. 참고: total_count 값은 실시간 스냅샷이므로 사용자가 음성을 생성, 수정 또는 삭제함에 따라 요청 간 변경될 수 있습니다. 페이지네이션에는 대신 has_more 플래그를 사용하세요. 성능 비용이 발생하므로 실제로 총 개수가 필요한 경우(예: 표시 목적)에만 활성화하세요.
voice_idslist of strings or null선택 사항

조회할 음성 ID입니다. 최대 100개의 음성 ID를 지정할 수 있습니다.

응답

성공 응답

voiceslist of objects

쿼리와 일치하는 음성 목록입니다.

has_moreboolean

이후 페이지에 사용할 수 있는 음성이 더 있는지 나타냅니다. total_count에 의존하지 말고 이 플래그와 next_page_token을 사용하여 안정적으로 페이지를 나누세요.

total_countinteger

쿼리와 일치하는 음성의 총개수입니다. 이 값은 현재 데이터베이스 상태를 반영하는 실시간 스냅샷이며, 사용자가 음성을 생성, 수정 또는 삭제함에 따라 요청 사이에 변경될 수 있습니다. 안정적인 페이지네이션을 위해 이 값에 의존하지 말고 has_more 플래그를 사용하세요. 이 필드를 계산하면 성능 비용이 발생하므로, 총개수가 실제로 필요한 경우(예: 표시 목적)에만 요청하세요.

next_page_tokenstring or null선택 사항

다음 결과 페이지를 조회하기 위한 토큰입니다. 페이지네이션을 계속하려면 다음 요청에 이 값을 전달하세요. 추가 결과가 없으면 Null입니다.

오류

422
Unprocessable Entity Error