QwenFastHigh

Qwen3 TTS

Alibaba's unified TTS with three modes: preset speakers (custom_voice), instant voice cloning from reference audio (voice_clone), and creating a brand-new voice from a text description (voice_design).

47 credits

per 1000 characters (0.045 credits/char, billed per character)

Three modes: preset voice, voice cloning, voice design

Voice design from natural-language description

9 preset speakers including Korean (Sohee)

10 language support with auto detection

Style/emotion instruction support

Run it right now

Test this model instantly in the Console Playground — no code required

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

llms.txtllms.txt ↗

Quick Start

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"
  }
}'

Parameters

Parameter	Type	Required	Default	Description
`text`	string	Yes	-	Text to synthesize into speech
`mode`	string	No	custom_voice	'custom_voice' uses preset speakers, 'voice_clone' clones from reference audio, 'voice_design' creates a voice from a description custom_voicevoice_clonevoice_design
`language`	string	No	auto	Language of the text ('auto' for automatic detection) autoChineseEnglishJapaneseKoreanFrenchGermanItalianSpanishPortugueseRussian
`speaker`	string	No	Serena	Preset speaker voice (custom_voice mode only) AidenDylanEricOno_annaRyanSerenaSoheeUncle_fuVivian
`voice_description`	string	No	-	Natural-language description of the desired voice (voice_design mode only), e.g. 'A warm, friendly female voice with a slight British accent'
`reference_audio`	string	No	-	Reference audio for voice cloning (voice_clone mode only)
`reference_text`	string	No	-	Transcript of the reference audio (recommended for voice_clone mode)
`style_instruction`	string	No	-	Optional style/emotion instruction, e.g. 'speak slowly and calmly'

How to Provide File Input

There are 3 ways to provide files for the reference_audio parameter:

Recommended

Direct Upload (Multipart)

Attach files directly to POST /v1/predictions/upload. No separate upload step needed.

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"

Image URL

Pass a publicly accessible URL directly. You can also use file_url from the Storage API.

{
  "model": "qwen/qwen3-tts",
  "input": {
    "prompt": "your prompt here",
    "reference_audio": "https://example.com/image.jpg"
  }
}

See the File Upload docs for more upload methods including Presigned URLs.

Common Parameters

Common parameters used when calling POST /v1/predictions.

Parameter	Type	Required	Default	Description
`model`	string	Yes	-	Model identifier
`input`	object	Yes	-	Object containing the model-specific parameters from the table above
`output_folder`	string	No	-	Folder path for output files (max 256 chars, '..' not allowed)
`webhook_url`	string	No	-	Webhook URL to call on completion
`is_public`	boolean	No	false	If true, output files are also available via permanent public URLs

Examples

Korean Preset Voice

Synthesize Korean speech with the Sohee preset

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"
  }
}'

Voice Design from Description

Create a brand-new voice from a text description

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"
  }
}'