API 엔드포인트
Search Voices
다양한 키워드와 필터를 사용해 보이스를 검색하세요.
GET
Search Voices API를 사용하면 다양한 필터링과 정렬 옵션을 통해 원하는 음성을 찾을 수 있습니다. 이 가이드는 검색 매개변수를 효과적으로 사용하는 방법을 설명합니다.
기본 사용법
음성을 검색하려면 /v1/voices/search
에 GET 요청을 보내세요. 여러 매개변수를 사용하여 결과를 필터링하고 정렬할 수 있습니다.
검색 논리
- 동일한 매개변수 내의 여러 값은 OR 논리로 결합됩니다 (쉼표로 구분)
- 서로 다른 매개변수는 AND 논리로 결합됩니다
- 매개변수를 지정하지 않으면 이름 오름차순으로 정렬된 첫 페이지의 20개 음성이 반환됩니다
사용 가능한 매개변수
필터 매개변수
language
- 사용 가능한 옵션:
ko
,ja
,en
- 예시:
language=en,ko
(영어 또는 한국어 음성 검색)
gender
- 사용 가능한 옵션:
male
,female
- 예시:
gender=male,female
age
- 사용 가능한 옵션:
child
,young-adult
,middle-aged
,elder
- 예시:
age=young-adult,middle-aged
use_case
- 사용 가능한 옵션:
advertisement
,announcement
,audiobook
,documentary
,education
,game
- 예시:
use_case=game,advertisement
search
- 이름과 설명 필드에서 검색
- 공백으로 구분된 키워드는 AND 논리로 검색
- 예시:
search=calm professional
페이지네이션
page
- 0부터 시작
- 기본값: 0
page_size
- 범위: 1-100
- 기본값: 20
정렬
sort
- 기본값:
name:asc
- 사용 가능한 옵션:
name:asc
,name:desc
age:asc
,age:desc
use_case:asc
,use_case:desc
language:asc
,language:desc
gender:asc
,gender:desc
요청 예시
응답 형식
API는 다음을 포함하는 JSON 응답을 반환합니다:
- 일치하는 음성 목록
- 총 일치 수
- 현재 페이지 번호
- 페이지 크기
- 총 페이지 수
응답 예시
Headers
API key for the service
Query Parameters
Search across name and description
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)
Page number (default: 0)
Number of items per page (default: 20, max: 100)
Sorting criteria (default: name:asc)