3가지 모드를 갖춘 Alibaba의 통합 TTS입니다: 프리셋 화자(custom_voice), 레퍼런스 오디오 기반 즉시 음성 복제(voice_clone), 텍스트 설명만으로 새로운 목소리 생성(voice_design).
콘솔의 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": "qwen/qwen3-tts",
"input": {
"mode": "custom_voice",
"text": "안녕하세요, 코어닷투데이입니다. 무엇을 도와드릴까요?",
"speaker": "Sohee",
"language": "auto"
}
}'| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
text | string | Yes | - | 음성으로 합성할 텍스트 |
mode | string | No | custom_voice | 'custom_voice'는 프리셋 화자, 'voice_clone'은 레퍼런스 오디오 복제, 'voice_design'은 설명 기반 음성 생성 custom_voicevoice_clonevoice_design |
language | string | No | auto | 텍스트 언어 ('auto'면 자동 감지) autoChineseEnglishJapaneseKoreanFrenchGermanItalianSpanishPortugueseRussian |
speaker | string | No | Serena | 프리셋 화자 (custom_voice 모드 전용) AidenDylanEricOno_annaRyanSerenaSoheeUncle_fuVivian |
voice_description | string | No | - | 원하는 목소리의 자연어 설명 (voice_design 모드 전용). 예: '따뜻하고 친근한 여성 목소리' |
reference_audio | string | No | - | 음성 복제용 레퍼런스 오디오 (voice_clone 모드 전용) |
reference_text | string | No | - | 레퍼런스 오디오의 대본 (voice_clone 모드에서 권장) |
style_instruction | string | No | - | 스타일/감정 지시문 (선택). 예: 'speak slowly and calmly' |
이 모델의 reference_audio 파라미터에 파일을 전달하는 방법은 3가지입니다.
POST /v1/predictions/upload에 파일을 직접 첨부합니다. 별도 업로드 과정이 필요 없습니다.
curl -X POST "https://api.core.today/v1/predictions/upload" \
-H "X-API-Key: cdt_your_api_key" \
-F "model=qwen/qwen3-tts" \
-F 'input={"prompt":"your prompt here"}' \
-F "file:reference_audio=@your_file.png"공개 접근 가능한 URL을 직접 전달합니다. Storage API로 업로드한 파일의 file_url도 사용 가능합니다.
{
"model": "qwen/qwen3-tts",
"input": {
"prompt": "your prompt here",
"reference_audio": "https://example.com/image.jpg"
}
}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로도 제공 |
Sohee 프리셋으로 한국어 음성 합성
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "qwen/qwen3-tts",
"input": {
"mode": "custom_voice",
"text": "안녕하세요, 코어닷투데이입니다. 무엇을 도와드릴까요?",
"speaker": "Sohee",
"language": "auto"
}
}'텍스트 설명만으로 새로운 목소리 생성
curl -X POST "https://api.core.today/v1/predictions" \
-H "Content-Type: application/json" \
-H "X-API-Key: cdt_your_api_key" \
-d '{
"model": "qwen/qwen3-tts",
"input": {
"mode": "voice_design",
"text": "Welcome aboard! This is your captain speaking.",
"voice_description": "A deep, confident male voice with a calm authoritative tone"
}
}'