🎙️ 수백 개 AI 음성 중 뭘 골라야 할까? — 문장으로 찾아주는 보이스 추천 API

 

콘텐츠에 딱 맞는 목소리를 찾는 건 생각보다 어려워요. 콘텐츠마다 어울리는 음성이 다르거든요. 제품 튜토리얼엔 차분하고 신뢰감 있는 안내 톤이, 브랜드 광고엔 활기찬 목소리가, 오디오북엔 나긋한 낭독 톤이 어울리죠. ‘좋은 목소리’가 아니라 ‘이 콘텐츠에 맞는 목소리’를 찾아야 하는 거예요.

그런데 고를 수 있는 음성이 많은 서비스일수록 오히려 그 하나를 찾기 더 어렵습니다. 수백 가지의 음성 중 딱 맞는 목소리를 고르려면 미리듣기를 반복하거나 성별·나이·모델 필터를 조합하며 시행착오를 거쳐야 하죠. 게다가 ‘따뜻한데 너무 딱딱하진 않은’ 같은 뉘앙스는 필터로 제공하지 않는 경우도 많고요.

타입캐스트 TTS API를 쓰는 분이라면 이런 고민을 하지 않아도 됩니다. 원하는 스타일을 문장으로 적으면 수백 개의 목소리 중 어울리는 보이스를 추천하는 보이스 추천 API가 새로 나왔거든요. 오늘은 어떻게 호출하는지, 그리고 원하는 목소리를 더 잘 찾는 프롬프트 작성법까지 실제 응답값과 함께 정리했습니다.

타입캐스트 API 무료로 시작하기 →

---

보이스 추천 API가 뭔가요?

보이스 추천 API는 원하는 스타일·분위기·언어·사용 사례를 문장이나 키워드로 적으면, 어울리는 타입캐스트 보이스를 관련도순으로 돌려주는 엔드포인트입니다. voice_id를 미리 알 필요 없이, 텍스트 묘사만으로 보이스를 검색하는 방식이에요. 요청에 넣을 건 딱 두 가지입니다.

응답에는 추천된 목소리 이름(voice_name)과 ID(voice_id), 그리고 관련도 점수(score)를 함께 안내해줘요. score가 1에 가까울수록 검색어에 잘 맞는 후보이고, 결과도 이 순서로 정렬됩니다. 마음에 드는 목소리의 voice_id로 원하는 대본을 음성으로 만들면(POST /v1/text-to-speech) 끝이에요.

---

“차분한 30대 남성 다큐 톤” — 이 한 문장이면 검색 끝

보이스 추천 API에 원하는 스타일을 문장으로 적으면, 어울리는 보이스가 관련도 점수와 함께 순서대로 나옵니다. 수백 개를 미리듣기로 넘기거나 필터를 조합하던 과정이 검색어 한 줄로 끝나는 거예요. 실제로 “차분한 30대 남성 다큐 톤”으로 검색하면 이렇게 나옵니다. 각 보이스는 자기가 몇 번째로 추천됐는지 직접 소개해줘요.

보이스 추천 API를 써서 편해지는 점은 세 가지예요.

• 수백 개의 음성을 직접 들어볼 필요가 없어요. 어떤 보이스가 있는지 몰라도, 원하는 톤을 문장으로 적으면 몇 초 만에 어울리는 후보가 관련도순으로 나오거든요.
• 필터로는 못 고르는 미묘한 뉘앙스도 찾아줘요. “따뜻한데 너무 딱딱하진 않은” 같은 느낌은 성별·나이처럼 정해진 항목으로는 콕 집어낼 수 없죠. 이렇게 정해진 값에 없는 특징도 자유롭게 문장으로 묘사하면 추천 API가 알아듣고 찾아줍니다.
• 코드로 자동화할 수 있어요. 보이스 선택을 사람이 매번 하지 않아도 돼서, 화자가 많은 콘텐츠나 대량 생성 파이프라인에도 적용해볼 수 있어요.

묘사를 바꾸면 결과가 얼마나 달라지는지도 들어보세요. 같은 API에 “무섭고 위협적인 게임 악당 캐릭터”를 넣으면, 앞서 나온 차분한 다큐 톤의 30대 남성과는 전혀 다른 보이스가 올라옵니다.

명령형·구어체로 적어도 괜찮아요. “차분한 아저씨 목소리”, “아이 같은 귀여운 목소리로”처럼 넣어도 각각 중년 남성·어린 목소리로 정확히 매칭됩니다.

---

직접 호출해보기

추천 결과를 받아 음성까지 만드는 과정은 네 단계면 됩니다.

STEP 1 API 키 발급받기

먼저 타입캐스트 API 키를 발급받아주세요. 발급·인증 방법 등 자세한 안내는 아래 페이지에서 살펴보세요. (무료 크레딧 30,000 제공)

타입캐스트 API 키 발급받기 →

STEP 2 보이스 추천 API로 원하는 목소리 검색하기

query에 원하는 보이스를 문장으로 적고, count로 받을 목소리 개수를 정해 호출해요.

curl -G 'https://api.typecast.ai/v1/voices/recommendations' \
  --data-urlencode 'query=따뜻하고 신뢰감 있는 여성, 제품 튜토리얼용' \
  --data-urlencode 'count=3' \
  -H 'X-API-KEY: 발급받은_API_키'

STEP 3 결과에서 원하는 보이스 고르기

관련도(score)가 높은 순서로 내려와요. 리스트의 음성을 듣고, 원하는 목소리의 voice_id를 복사하면 됩니다.

[
  { "voice_id": "tc_660e5c29eef728e75f95f538", "voice_name": "Patricia", "score": 0.89 },
  { "voice_id": "tc_63049449e7dfae64b10c6cb9", "voice_name": "Agatha",   "score": 0.88 },
  { "voice_id": "tc_68f9c6a72f0f04a417bb136f", "voice_name": "Moonjung", "score": 0.88 }
]

STEP 4 고른 보이스로 음성 만들기

고른 voice_id로 음성을 만들면 끝이에요.

curl -X POST 'https://api.typecast.ai/v1/text-to-speech' \
  -H 'X-API-KEY: 발급받은_API_키' \
  -H 'Content-Type: application/json' \
  -d '{
    "voice_id": "tc_660e5c29eef728e75f95f538",
    "text": "안녕하세요, 이 기능의 사용법을 차근차근 알려드릴게요.",
    "model": "ssfm-v30"
  }'

---

보이스 추천 API, 더 잘 쓰는 꿀팁

같은 보이스 추천 API라도 query를 어떻게 쓰느냐에 따라 결과가 꽤 달라져요. 그래서 제가 직접 여러 방식으로 쿼리를 넣어보고, 원하는 보이스에 더 가까워지는 규칙을 정리해봤어요. 결론부터 말하면 세 가지만 순서대로 적으면 됩니다.

이 세 가지를 채울 때 결과가 더 좋아지는 TIP을 소개합니다.

• 분위기·톤 형용사는 반드시 포함하세요. 세 가지 중 결과를 가장 크게 바꾸는 게 형용사거든요. 여성만 넣으면 후보가 두루뭉술한데, 차분한 여성으로 한 단어만 붙여도 원하는 톤에 훨씬 가까워집니다.
• 콘텐츠 용도를 같이 적으세요. 오디오북·숏폼·다큐·이러닝·광고·게임처럼 쓰임새를 넣으면 그 용도에 어울리는 보이스로 후보가 더 잘 좁혀져요.
• 문법은 신경 쓰지 마세요. 완결된 문장이 아니어도 괜찮아요. “차분한, 30대 여성, 오디오북”처럼 키워드만 쉼표로 나열해도 문장으로 쓴 것과 결과가 거의 같았거든요.

---

FAQ. 자주 묻는 질문

---