​
현재(2025년 5월 28일 이후) 정식 버전의 배포가 완료되었습니다.

현재 정식 API 버전/v1/...)이 2025년 5월 28일자로 배포 완료되었으며, 신규 연동 시에는 더 이상 샌드박스 엔드포인트를 사용하지 마시고 /v1버전을 연동해 주세요.

이미 샌드박스에 연동해 사용 중이라면:
2025년 6월 6일 이전까지 /sandbox/... → /v1/...으로 URL만 수정하시면 됩니다.

샌드박스를 연동해 사용한 적이 없다면:
이 문서는 건너뛰고, 정식 버전 문서만 참고하셔도 충분합니다.

📄 정식 문서 보러가기: API 레퍼런스

샌드박스 환경에서는 기존 보이스 ID 체계가 완전히 새롭게 개편됩니다.
기존의 {character-language-style} 형태의 복잡한 보이스 ID는 사라지고,
이제는 캐릭터 단위의 voice_id + 파라미터( language , style) 조합으로 간결하게 호출합니다.

​
🗂 보이스 ID 매핑표 다운로드

🔗 Voice ID 매핑 시트 보기

시트에서는 기존 Old Voice ID와 신규 New Voice ID + language/style 파라미터를 1:1로 확인하실 수 있습니다.
예를 들어, 다음과 같이 교체됩니다:

Old Voice IDNew Voice IDNamelanguagestyle
wq4QNZra8YVCTWGVXbC91992bbd4758bdcf9c9b0Adamkoneutral
vG4KaR4wwG5mvdCJfyrbWN7d6fa2e0c4abfd9e1acc4cYoonhoenhappy

해당 매핑표에는 캐릭터별 다양한 스타일 조합이 포함되어 있으며,
기존에 없던 캐릭터나 신규 스타일도 대거 추가되어 있습니다.

​
✅ 교체 방법

  1. 기존에 사용하던 Old Voice ID를 매핑표에서 검색하세요.
  2. 해당하는 New Voice ID와 함께, language/style 파라미터를 추출합니다.
  3. API 호출 시, voice_id에는 새 ID를 입력하고, language, style은 파라미터로 함께 넘겨주세요.
POST /sandbox/text-to-speech/{91992bbd4758bdcf9c9b0}
{
  "text": "예시 문장입니다.",
  "language": "ko",
  "style": "neutral"
}

​
🧭 참고 사항

  • 대부분의 경우, style은 neutral이 기본값이며 optional입니다.
    입력하지 않으면 시스템에 설정된 기본 스타일로 음성이 생성됩니다.
  • 새로운 시스템에서는 같은 캐릭터 ID로 다양한 스타일/언어를 선택적으로 호출할 수 있습니다.

​
❓ 찾는 보이스 ID가 없나요?

매핑표에서 기존에 사용하던 Old Voice ID를 찾을 수 없다면,
이는 해당 보이스가 새 모델에서 지원되지 않거나 통합되었을 수 있습니다.
고객 지원 으로 문의 주시면 빠르게 확인해드리겠습니다.