Skip to main content
GET
음성 모델 목록 조회

Authorizations

Authorization
string
header
required

워크스페이스 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.

Query Parameters

q
string | null

음성 이름(name) 일부로 검색합니다. 대소문자를 구분하지 않습니다.

provider
string | null

음성 provider 필터입니다. 허용값에는 google, elevenlabs, cartesia, openai 등이 있습니다.

language
string | null

음성 언어 필터입니다. ko-KR, *처럼 이 endpoint가 반환한 값을 사용합니다.

gender
enum<string> | null

음성 성별 필터입니다. male 또는 female을 사용합니다.

Available options:
male,
female
is_public
boolean | null

true이면 공개 보이스만, false이면 비공개 보이스만 조회합니다.

model
string | null

TTS 모델 필터입니다. 응답 항목의 model 값을 사용합니다(예: eleven_v4_turbo).

cursor
string | null

이전 응답의 next_cursor 값입니다. 다음 페이지를 조회할 때 그대로 전달합니다.

limit
integer
default:50

반환할 최대 항목 수입니다. v3 목록 endpoint는 1~100을 허용합니다.

Required range: 1 <= x <= 100

Response

성공 응답

Voice 모델 카탈로그 (public + 현재 조직 private).

items
VoiceModelResponse · object[]
required

페이지 항목입니다.

total_count
integer
required

조건에 맞는 전체 항목 수입니다.

next_cursor
string | null

다음 페이지 커서입니다. 조회할 항목이 더 없으면 null입니다.