다양한 조건으로 보이스를 필터링할 수 있는 Search Voices API의 파라미터 사용법과 검색 예시를 설명합니다.
파라미터 | 설명 | 예시 |
---|---|---|
name | 보이스 이름으로 검색 (부분 일치) | My Voice (→ 클론 보이스 찾기) |
language | 보이스의 언어 코드 (쉼표로 다중 입력 가능) | ko , en , ja |
gender | 보이스의 성별 (쉼표로 다중 입력 가능) | male , female |
age | 보이스의 연령대 | teen , adult , senior 등 |
use_case | 추천 사용처 기반 필터 | audiobook , narration , advertisement 등 |
style | 감정 스타일 필터 (가장 앞에 오는 값이 디폴트) | neutral , happy , sad , angry 등 |
model | 지원하는 음성 모델 기준 필터 | sona_speech_1 등 |
page_size | 한 페이지당 항목 수 (기본값: 20, 최대: 100) | 50 |
next_page_token | 페이지네이션을 위한 토큰 | 이전 응답에서 받은 nextPageToken 값 |
⚠️ sort
파라미터는 지원하지 않습니다.
My Voice
)를 검색하여 voice_id
를 얻을 수 있습니다.
next_page_token
값은 이전 응답에서 받아올 수 있습니다.items
배열과 next_page_token
값을 포함하며, 각 보이스의 voice_id
, 스타일, 샘플 URL 등도 함께 제공됩니다.
API key for the service
Number of items per page (default: 20, max: 100)
Search across name. Space separated.
Search across description. Space separated.
Filter by language (comma-separated)
Filter by gender (comma-separated)
Filter by age (comma-separated)
Filter by use case (comma-separated)
Filter by style (comma-separated)
Filter by model (comma-separated)
Token for pagination (obtained from the previous page's response)
Paginated available voices response with next page token
The response is of type object
.