Voice Clone TTS

Provide text and a voice (speaker) to synthesize speech in that voice (voice cloning). No file upload required — the input is text.

Create Task

Basics

Item	Value
Method	`POST`
Path	`/task/audio_tts_clone`
Content-Type	`application/json`
Auth	`Authorization` header (pass the API Key directly)

Request Body

Field	Type	Required	Default	Description
`text`	`string`	Yes	—	Text to synthesize; non-empty, up to 2000 characters
`speaker`	`string`	Yes	—	Voice code (see "Available Voices" below)
`text_lang`	`string`	No	`zh`	Target language; phase 1 supports Chinese `zh`
`output_format`	`string`	No	`wav`	Output audio format: `wav` or `mp3`
`speed`	`number`	No	voice preset	Speech speed factor (`0.5 ~ 2.0`); defaults to the voice's preset speed

Available Voices (speaker)

Voice	Code (speaker)	Gender
Narrator	`narrator`	Male
Sweet Girl (internal members only)	`sweet_female`	Female
Cantonese Sister	`cantonese_accent`	Female
Radio Hostess	`radio_female`	Female
Heartwarming Sister	`heartwarming_female`	Female
Kind Voice	`kind_female`	Female
Lecturer	`lecturer`	Male
Professor Fran	`professor_fran`	Male
Energetic Female (internal members only)	`energetic_female`	Female

The voice list is updated over time; refer to the latest docs before calling. "Demo" plays a sample clip per voice. Voices marked "internal members only" are available to Gitruck Cloud internal members; other accounts requesting them receive a parameter error explaining why.

Billing

Billed by synthesized duration (minutes). Because the audio is the output (no input audio to probe at creation time), the duration is estimated from the character count (Chinese ≈ 200 chars/minute).

Example Request

curl -X POST https://api.ai-mcn.tv:10000/task/audio_tts_clone \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello, welcome to this episode.",
    "speaker": "narrator",
    "output_format": "wav",
    "speed": 1.0
  }'

Success Response

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178247",
    "task_type": "audio_tts_clone",
    "status": "queued"
  }
}

Query Task Result

Basics

Item	Value
Method	`GET`
Path	`/task/audio_tts_clone/{task_id}`
Auth	`Authorization` header (pass the API Key directly)

Response (output_result)

Field	Type	Description
`file_id`	`string`	Synthesized audio file ID
`download_url`	`string`	Audio download path
`speaker`	`string`	Voice code used

Success Response

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178247",
    "status": "completed",
    "progress": 100,
    "output_result": {
      "file_id": "537489015178248",
      "download_url": "/download/a1/output_tts.wav",
      "speaker": "narrator"
    },
    "create_time": "2026-06-21T08:00:00Z",
    "update_time": "2026-06-21T08:00:12Z"
  }
}

Error Codes

Code	HTTP	Description	Resolution
`6013`	400	Missing required parameter (`text` / `speaker`)	Provide the parameter
`6011`	400	Invalid business parameter (unavailable speaker, text too long, speed out of range, etc.)	Fix per the parameter spec
`6502`	401	Authentication failed	Check the `Authorization` header
`6201`	402	Insufficient quota	Top up in the dashboard
`6202`	402	Insufficient balance	Top up in the dashboard

Limits

Up to 2000 characters per request; split longer text into multiple calls.
Phase 1 supports Chinese (zh) target language only.
Only authorized, quality-approved voices are available (see "Available Voices").
Voices marked "internal members only" require Gitruck Cloud internal membership; other accounts requesting them receive a parameter error (no silent fallback to another voice).