Typecast
고객 지원API 콘솔로 이동
보이스

보이스 추천

SDK

수동 HTTP 호출보다 안전하고 빠른 통합을 위해 SDK를 사용하세요.

SDK 가이드

텍스트 묘사를 기반으로 조건에 맞는 타입캐스트 보이스를 추천하는 API입니다.

voice_id를 직접 조회할 필요 없이, 원하는 스타일·분위기·언어·사용 사례 등의 키워드나 문장으로 보이스를 검색할 수 있습니다. 응답은 추천 점수 순서로 정렬되며, 상위 후보의 voice_id를 POST /v1/text-to-speech 같은 텍스트 음성 변환 엔드포인트에 바로 전달할 수 있습니다.

응답에는 voice_id, voice_name, score만 포함됩니다. 추천된 보이스의 지원 모델, 감정, 성별, 나이대, 사용 사례 같은 상세 메타데이터가 필요하면 GET /v3/voices 또는 GET /v3/voices/{voice_id}를 함께 호출하세요.

GET/v1/voices/recommendations

인증

X-API-KEYstringheader필수

인증을 위한 API 키입니다. Typecast API 콘솔에서 API 키를 발급받을 수 있습니다.

쿼리 매개변수

querystringrequired

텍스트 묘사. 원하는 스타일, 분위기, 언어, 사용 사례, 콘텐츠 맥락을 키워드나 문장으로 설명합니다.

countinteger

필터링 후 반환할 추천 보이스 최대 개수. 1~10 사이의 값이어야 합니다. 조건에 맞는 후보가 충분하지 않으면 count보다 적은 수의 보이스가 반환될 수 있습니다.

응답

200Success - Returns recommended voices sorted by scoreapplication/json
scorenumber

추천 관련도 점수. 값이 높을수록 검색어와 더 잘 맞는 후보입니다.

voice_idstring

tc_ prefix 가 붙은 타입캐스트 보이스 식별자. 텍스트 음성 변환 요청의 voice_id 로 사용할 수 있습니다.

voice_namestring

사람이 읽을 수 있는 보이스 이름.

⌘I