108개 음성, 6개 언어를 지원하는 네이버 클로바 보이스 프리미엄 TTS. 고품질 한국어 음성 합성, 감정 표현, Pro 음성, 이중 언어 지원.
콘솔의 Playground에서 별도 코드 없이 이 모델을 즉시 테스트할 수 있어요
이 모델의 사용법을 Claude, ChatGPT 등에 복사
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "ncp-clova/tts-premium",
"input": {
"text": "안녕하세요, 코어닷투데이입니다. 최고의 AI 서비스를 경험해 보세요!",
"speaker": "vara",
"emotion": 2,
"emotion-strength": 2,
"speed": 0,
"format": "mp3"
}
}'모든 음성이 같은 문장을 읽습니다. 재생해 음색을 비교하고, ID를 눌러 복사해 reference_id 에 넣으세요.
샘플 문장: “안녕하세요? 코어닷투데이에 오신 것을 환영합니다”
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
text | string | Yes | - | 변환할 텍스트 (UTF-8). 한/중/일/대만 최대 2,000자, 영어/스페인어 최대 3,000자. |
speaker | string | Yes | nara | 음성 종류. 108개: 한국어 81개, 일본어 15개, 영어 4개, 한국어+영어 2개, 중국어 2개, 스페인어 2개, 대만어 2개. dara_angjinhomijinnapplenara_callnaranborandaeseongndainndonghyunnes_c_hyerines_c_kihyones_c_mikyungnes_c_sohyunneunseoneunwooneunyoungngaramngoeunngyeongjunnhajunnheeraniannihyunnjaewooknjangjnjihunnjihwannjinhonjiwonnjiyunnjonghyeoknjonghyunnjooahnnjoonyoungnkitaenkyungleenkyungtaenkyuwonnmammonnmeownmijinnminjeongnminsangnminseonminyoungnmovienoyjnraewonnreviewnsabinansangdonseonghoonnseungpyonshashansinunsiyoonnsujinnsunheensunkyungntaejinntiffanynwontaknwoofnwoosiknyejinyejinnyounghwanyoungilnyoungminyujinnyunavaravdaeseongvdainvdonghyunvgoeunvhyerivianvmikyungvyunadara-dannadsinu-mattliangliangmeimeidayumuddaikiderikodhajimedmiodnaomidnaomi_formaldnaomi_joyfuldrikodsayuridtomokonnaominsayurintomokoshinjiclaradannadjoeymattcarmenjosechiahuakuanlin |
volume | integer | No | 0 | 음성 볼륨 (-5 ~ 5, 기본값 0) |
speed | integer | No | 0 | 음성 속도 (-5 ~ 10, 기본값 0) |
pitch | integer | No | 0 | 음성 높낮이 (-5 ~ 5, 기본값 0) |
emotion | integer | No | 0 | 감정 (0: 중립, 1: 슬픔, 2: 기쁨, 3: 분노). nara(0~2, 분노 미지원)와 Pro 음성 vara·vmikyung·vdain·vyuna·vgoeun·vdaeseong(0~3)만 지원하고, 그 외 화자는 0만 가능합니다. 0123 |
emotion-strength | integer | No | - | 감정 강도 (0: 약하게, 1: 보통, 2: 강하게). Pro 음성 vara·vmikyung·vdain·vyuna·vgoeun·vdaeseong만 지원합니다. nara를 포함한 그 외 화자에는 보내지 마세요 — 요청이 거절됩니다. 생략하면 CLOVA가 1을 적용합니다. 012 |
format | string | No | mp3 | 오디오 출력 형식 mp3wav |
POST /v1/predictions 요청 시 사용되는 공통 파라미터입니다.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | Yes | - | 모델 식별자 |
input | object | Yes | - | 위 테이블의 모델별 파라미터를 포함하는 객체 |
output_folder | string | No | - | 결과물 저장 폴더 경로 (최대 256자, '..' 사용 불가) |
webhook_url | string | No | - | 완료 시 호출할 Webhook URL |
is_public | boolean | No | false | true 시 결과물을 영구 공개 URL로도 제공 |
Pro 음성 'vara'로 강한 기쁨 감정이 담긴 한국어 음성 생성
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "ncp-clova/tts-premium",
"input": {
"text": "안녕하세요, 코어닷투데이입니다. 최고의 AI 서비스를 경험해 보세요!",
"speaker": "vara",
"emotion": 2,
"emotion-strength": 2,
"speed": 0,
"format": "mp3"
}
}'