메인 콘텐츠로 건너뛰기
GET
/
v1
/
voices
/
recommendations
cURL
curl --request GET \
  --url 'https://api.typecast.ai/v1/voices/recommendations?query=warm%20female%20voice%20for%20product%20tutorial&count=5' \
  --header 'X-API-KEY: <api-key>'
[
  {
    "voice_id": "tc_60e5426de8b95f1d3000d7b5",
    "voice_name": "Olivia",
    "score": 0.92
  },
  {
    "voice_id": "tc_62a8975e695ad26f7fb514d1",
    "voice_name": "Emma",
    "score": 0.87
  }
]

인증

​
X-API-KEY
string
header
필수

인증을 위한 API 키. 타입캐스트 API 콘솔에서 API 키를 생성할 수 있습니다.

쿼리 매개변수

​
query
string
필수

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

Required string length: 1 - 500
​
count
integer
기본값:5

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

필수 범위: 1 <= x <= 10

응답

Success - Returns recommended voices sorted by score

Maximum array length: 10
​
voice_id
string
필수

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

예시:

"tc_60e5426de8b95f1d3000d7b5"

​
voice_name
string
필수

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

예시:

"Olivia"

​
score
number
필수

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

예시:

0.92