# Clova Voice TTS Premium

> NAVER Clova Voice Premium TTS - 고품질 한국어/영어/일본어/중국어 음성 합성. 감정 표현 및 다양한 화자 지원.

- **Provider**: ncp-clova
- **Model ID**: ncp-clova/tts-premium
- **Category**: tts_voice
- **Credits**: 124 per request
- **Pricing Type**: token_based

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `volume` (integer, optional): 음성 볼륨 (-5 ~ 5, 기본값 0) (Default: `0`; Range: min: -5, max: 5)
- `emotion-strength` (integer, optional): 감정 강도 (0: 약하게, 1: 보통, 2: 강하게) (Default: `1`; Options: `0`, `1`, `2`)
- `emotion` (integer, optional): 감정 (0: 중립, 1: 슬픔, 2: 기쁨, 3: 분노). 일부 화자만 지원. (Default: `0`; Options: `0`, `1`, `2`, `3`)
- `speaker` (string, **required**): 음성 종류 (108개). 한국어 81개, 일본어 14개, 영어 4개, 한국어+영어 2개, 중국어 2개, 스페인어 2개, 대만어 2개, Pro 음성 9개 포함. (Default: `nara`; Options: `dara_ang`, `jinho`, `mijin`, `napple`, `nara_call`, `nara`, `nbora`, `ndaeseong`, `ndain`, `ndonghyun`, `nes_c_hyeri`, `nes_c_kihyo`, `nes_c_mikyung`, `nes_c_sohyun`, `neunseo`, `neunwoo`, `neunyoung`, `ngaram`, `ngoeun`, `ngyeongjun`, `nhajun`, `nheera`, `nian`, `nihyun`, `njaewook`, `njangj`, `njihun`, `njihwan`, `njinho`, `njiwon`, `njiyun`, `njonghyeok`, `njonghyun`, `njooahn`, `njoonyoung`, `nkitae`, `nkyunglee`, `nkyungtae`, `nkyuwon`, `nmammon`, `nmeow`, `nmijin`, `nminjeong`, `nminsang`, `nminseo`, `nminyoung`, `nmovie`, `noyj`, `nraewon`, `nreview`, `nsabina`, `nsangdo`, `nseonghoon`, `nseungpyo`, `nshasha`, `nsinu`, `nsiyoon`, `nsujin`, `nsunhee`, `nsunkyung`, `ntaejin`, `ntiffany`, `nwontak`, `nwoof`, `nwoosik`, `nyeji`, `nyejin`, `nyounghwa`, `nyoungil`, `nyoungmi`, `nyujin`, `nyuna`, `vara`, `vdaeseong`, `vdain`, `vdonghyun`, `vgoeun`, `vhyeri`, `vian`, `vmikyung`, `vyuna`, `dara-danna`, `dsinu-matt`, `liangliang`, `meimei`, `dayumu`, `ddaiki`, `deriko`, `dhajime`, `dmio`, `dnaomi`, `dnaomi_formal`, `dnaomi_joyful`, `driko`, `dsayuri`, `dtomoko`, `nnaomi`, `nsayuri`, `ntomoko`, `shinji`, `clara`, `danna`, `djoey`, `matt`, `carmen`, `jose`, `chiahua`, `kuanlin`)
- `format` (string, optional): 오디오 출력 형식 (Default: `mp3`; Options: `mp3`, `wav`)
- `text` (string, **required**): 변환할 텍스트 (UTF-8). 한/중/일/대만 최대 2,000자, 영어/스페인어 최대 3,000자.
- `pitch` (integer, optional): 음성 높낮이 (-5 ~ 5, 기본값 0) (Default: `0`; Range: min: -5, max: 5)
- `speed` (integer, optional): 음성 속도 (-5 ~ 10, 기본값 0) (Default: `0`; Range: min: -5, max: 10)

## Example Request

```json
{
  "model": "ncp-clova/tts-premium",
  "input": {
    "volume": 0,
    "emotion-strength": 1,
    "emotion": 0,
    "speaker": "nara",
    "format": "mp3",
    "text": "\uc548\ub155\ud558\uc138\uc694. \ucf54\uc5b4\ub2f7 AI API \uac8c\uc774\ud2b8\uc6e8\uc774\uc758 \uc74c\uc131\ud569\uc131 \uc11c\ube44\uc2a4\uc785\ub2c8\ub2e4.",
    "pitch": 0,
    "speed": 0
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

url

## Tags

text-to-speech, tts, korean, clova, naver, voice-synthesis, multilingual

## Documentation

https://api.ncloud-docs.com/docs/ai-naver-clovavoice-ttspremium


## Token Pricing

- Input: 0.124 credits/token
- Output: 0.124 credits/token