---
title: Qwen3-TTS 1.7B CustomVoice | Runware Docs
url: https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice
description: Text-to-speech with preset premium timbres and precise style control
---
# Qwen3-TTS 1.7B CustomVoice

![Qwen3-TTS 1.7B CustomVoice](https://assets.runware.ai/covers/alibaba-qwen3-tts-1-7b-customvoice.jpg)

Qwen3-TTS 1.7B CustomVoice is a text-to-speech model from Alibaba that offers nine premium preset timbres across various combinations of gender, age, language, and dialect. It provides precise style control over target voices through user instructions, supports voice cloning from a 3-second sample, and generates speech in 10+ languages with latency as low as 97ms.

- **Status**: live
- **ID**: `alibaba:qwen@3-tts-1.7b-customvoice`
- Try in Playground
- **Creator**: Alibaba
- **Release Date**: January 1, 2026
- **Zero Data Retention**: Yes
- **Capabilities**: Text to Audio, Checkpoint

## Pricing

$0.000015 per character · ~6s per request

**4 example generations**

- [text-to-audio](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice/examples#example-roller-derby-broadcast-vocal-stinger): `$0.0015` (~2s)
- [text-to-audio](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice/examples#example-geothermal-control-room-voice-bed): `$0.0048` (~5s)
- [text-to-audio](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice/examples#example-natural-return-service-explainer-voiceover): `$0.0084` (~8s)
- [text-to-audio](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice/examples#example-seaweed-feed-technology-explainer-voiceover): `$0.0106` (~8s)

times vary, measured end to end · [How pricing works](https://runware.ai/docs/models-api/pricing)

## Request Parameters

**API Options**

Platform-level options for task execution and delivery.

### [taskType](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#request-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `audioInference`

Identifier for the type of task being performed.

### [taskUUID](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#request-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.

### [outputType](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#request-outputtype)

- **Type**: `string`
- **Default**: `URL`

Audio output type.

**Allowed values**: `URL` `base64Data` `dataURI`

### [outputFormat](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#request-outputformat)

- **Type**: `string`
- **Default**: `MP3`

Specifies the file format of the generated output. The available values depend on the task type and the specific model's capabilities.

- \`MP3\`: Compressed audio, smaller file size.
- \`WAV\`: Uncompressed, high-quality audio.
- \`FLAC\`: Lossless compression.
- \`OGG\`: Open-source compressed audio format (Vorbis codec).

**Allowed values**: `MP3` `WAV` `FLAC` `OGG`

### [audioSettings](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#request-audiosettings)

- **Path**: `audioSettings.bitrate`
- **Type**: `object (3 properties)`

Audio encoding settings for controlling the bitrate, number of channels, and sample rate of the generated audio. Only applicable for lossy output formats (`MP3` and `OGG`). When using lossless formats (`WAV` or `FLAC`), this parameter must not be provided.

The available sample rates and valid bitrate ranges depend on the output format. For `OGG`, bitrate limits also vary by the number of channels.

**MP3 bitrate limits**:

Bitrate limits for MP3 are the same regardless of mono or stereo.

| Sample Rate | Min Bitrate | Max Bitrate |
| --- | --- | --- |
| 8,000 Hz | 8 kbps | 64 kbps |
| 11,025 Hz | 8 kbps | 64 kbps |
| 12,000 Hz | 8 kbps | 64 kbps |
| 16,000 Hz | 8 kbps | 160 kbps |
| 22,050 Hz | 8 kbps | 160 kbps |
| 24,000 Hz | 8 kbps | 160 kbps |
| 32,000 Hz | 32 kbps | 320 kbps |
| 44,100 Hz | 32 kbps | 320 kbps |
| 48,000 Hz | 32 kbps | 320 kbps |

**OGG bitrate limits — Mono (1 channel)**:

| Sample Rate | Min Bitrate | Max Bitrate |
| --- | --- | --- |
| 8,000 Hz | 8 kbps | 40 kbps |
| 12,000 Hz | 16 kbps | 48 kbps |
| 16,000 Hz | 16 kbps | 96 kbps |
| 24,000 Hz | 16 kbps | 80 kbps |
| 48,000 Hz | 32 kbps | 224 kbps |

**OGG bitrate limits — Stereo (2 channels)**:

| Sample Rate | Min Bitrate | Max Bitrate |
| --- | --- | --- |
| 8,000 Hz | 16 kbps | 80 kbps |
| 12,000 Hz | 16 kbps | 96 kbps |
| 16,000 Hz | 24 kbps | 192 kbps |
| 24,000 Hz | 32 kbps | 160 kbps |
| 48,000 Hz | 48 kbps | 256 kbps |

> [!NOTE]
> **Lossless formats**: When `outputFormat` is set to `WAV` or `FLAC`, the `audioSettings` parameter is not available since these formats produce uncompressed or lossless audio with no configurable encoding settings.

#### [bitrate](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#request-audiosettings-bitrate)

- **Path**: `audioSettings.bitrate`
- **Type**: `integer`
- **Min**: `8`

Audio bitrate in kbps.

#### [channels](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#request-audiosettings-channels)

- **Path**: `audioSettings.channels`
- **Type**: `integer`
- **Default**: `2`

Number of audio channels. 1 for mono, 2 for stereo.

**Allowed values**: `1` `2`

#### [sampleRate](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#request-audiosettings-samplerate)

- **Path**: `audioSettings.sampleRate`
- **Type**: `integer`

Audio sample rate in Hz.

### [webhookURL](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#request-webhookurl)

- **Type**: `string`
- **Format**: `uri`

Webhook URL that receives JSON responses via HTTP POST when generation tasks complete. For batch requests with multiple results, each completed item triggers a separate webhook call as it becomes available.

**Learn more** (1 resource):

- [Webhooks](https://runware.ai/docs/models-api/webhooks) (platform)

### [deliveryMethod](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#request-deliverymethod)

- **Type**: `string`
- **Default**: `sync`

Determines how the API delivers task results.

**Allowed values**:

- `sync` Returns results directly in the API response. Over HTTP, a task still running after 120 seconds continues as an async task and comes back with status 'processing'. Poll for its results using getResponse.
- `async` Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse.

**Learn more** (1 resource):

- [Task Polling](https://runware.ai/docs/models-api/task-polling) (platform)

### [uploadEndpoint](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#request-uploadendpoint)

- **Type**: `string`
- **Format**: `uri`

Specifies a URL where the generated content will be automatically uploaded using the HTTP PUT method. The raw binary data of the media file is sent directly as the request body. For secure uploads to cloud storage, use presigned URLs that include temporary authentication credentials.

**Common use cases:**

- **Cloud storage**: Upload directly to S3 buckets, Google Cloud Storage, or Azure Blob Storage using presigned URLs.
- **CDN integration**: Upload to content delivery networks for immediate distribution.

```text
// S3 presigned URL for secure upload
https://your-bucket.s3.amazonaws.com/generated/content.mp4?X-Amz-Signature=abc123&X-Amz-Expires=3600

// Google Cloud Storage presigned URL
https://storage.googleapis.com/your-bucket/content.jpg?X-Goog-Signature=xyz789

// Custom storage endpoint
https://storage.example.com/uploads/generated-image.jpg
```

The content data will be sent as the request body to the specified URL when generation is complete.

### [ttl](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#request-ttl)

- **Type**: `integer`
- **Min**: `60`

Time-to-live (TTL) in seconds for generated content. Only applies when `outputType` is `URL`.

### [includeCost](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#request-includecost)

- **Type**: `boolean`

Include task cost in the response.

### [numberResults](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#request-numberresults)

- **Type**: `integer`
- **Min**: `1`
- **Max**: `4`
- **Default**: `1`

Number of results to generate. Each result uses a different seed, producing variations of the same parameters.

**Core Parameters**

Primary parameters that define the task output.

### [model](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#request-model)

- **Type**: `string`
- **Required**: true
- **Value**: `alibaba:qwen@3-tts-1.7b-customvoice`

Send `auto` instead of an AIR identifier to have the model router choose the model for this task. The rest of the request is unchanged, every value you send is kept, and only the parameters you leave out are filled in. See [Model Router](https://runware.ai/docs/models-api/model-router).

**Learn more** (3 resources):

- [Text To Image: Model Selection](https://runware.ai/docs/learn/text-to-image#model-selection) (learn)
- [Image Inpainting: Model Specialized Inpainting Models](https://runware.ai/docs/learn/image-inpainting#model-specialized-inpainting-models) (learn)
- [Image Outpainting: Other Critical Parameters](https://runware.ai/docs/learn/image-outpainting#other-critical-parameters) (learn)

### [positivePrompt](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#request-positiveprompt)

- **Type**: `string`

Optional style or emotion hint for the voice. Example: 'Speak with great enthusiasm'.

**Learn more** (1 resource):

- [Prompts](https://runware.ai/docs/learn/prompts) (learn)

### [speech](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#request-speech)

- **Path**: `speech.text`
- **Type**: `object (4 properties)`
- **Required**: true

Settings for speech generation.

#### [text](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#request-speech-text)

- **Path**: `speech.text`
- **Type**: `string`
- **Required**: true
- **Max**: `2000`

Text to convert to speech.

#### [voice](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#request-speech-voice)

- **Path**: `speech.voice`
- **Type**: `string`
- **Required**: true

Voice identifier to use for speech generation.

**Allowed values**: `aiden` `dylan` `eric` `ono_anna` `ryan` `serena` `sohee` `uncle_fu` `vivian`

#### [language](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#request-speech-language)

- **Path**: `speech.language`
- **Type**: `string`
- **Min**: `1`
- **Default**: `Auto`

Language code for speech generation.

**Allowed values**: `Auto` `Chinese` `English` `Japanese` `Korean` `German` `French` `Russian` `Portuguese` `Spanish` `Italian`

#### [speed](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#request-speech-speed)

- **Path**: `speech.speed`
- **Type**: `float`
- **Min**: `0.25`
- **Max**: `4`
- **Step**: `0.01`
- **Default**: `1`

Playback speed of the generated speech.

**Settings**

Technical parameters to fine-tune the inference process. These must be nested inside the \`settings\` object.

### [maxNewTokens](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#request-settings-maxnewtokens)

- **Path**: `settings.maxNewTokens`
- **Type**: `integer`
- **Default**: `2048`

Audio output token cap. Higher values allow longer audio but risk hangs.

## Response Parameters

### [taskType](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#response-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `audioInference`

Identifier for the type of task this response belongs to.

### [taskUUID](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#response-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier echoed from the original request, used to match async responses to their tasks.

### [audioUUID](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#response-audiouuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID of the output audio.

### [audioURL](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#response-audiourl)

- **Type**: `string`
- **Format**: `uri`

URL of the output audio.

### [audioBase64Data](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#response-audiobase64data)

- **Type**: `string`

Base64-encoded audio data.

### [audioDataURI](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#response-audiodatauri)

- **Type**: `string`
- **Format**: `uri`

Data URI of the output audio.

### [cost](https://runware.ai/docs/models/alibaba-qwen3-tts-1-7b-customvoice#response-cost)

- **Type**: `float`

Task cost in USD. Present when `includeCost` is set to `true` in the request.

## Examples

### text-to-audio (text-to-audio)

[Listen to audio](https://assets.runware.ai/examples/alibaba-qwen3-tts-1-7b-customvoice/410e291b-837c-4a48-bb20-937444324371.wav)

> **Prompt**: Steel sings. Wheels spark. Welcome to the Night Shift Derby Report—fast calls, hard turns, no brakes.

```json
{
  "taskType": "audioInference",
  "taskUUID": "5b1bac8e-d1ee-46af-8153-b945d1909d36",
  "model": "alibaba:qwen@3-tts-1.7b-customvoice",
  "positivePrompt": "Deliver as a high-energy sports broadcast stinger with crisp diction, a driving percussive cadence, and dramatic micro-pauses. Build intensity through the final phrase and finish with confident impact.",
  "speech": {
    "text": "Steel sings. Wheels spark. Welcome to the Night Shift Derby Report—fast calls, hard turns, no brakes.",
    "voice": "serena",
    "language": "English"
  }
}
```

---

### text-to-audio (text-to-audio)

[Listen to audio](https://assets.runware.ai/examples/alibaba-qwen3-tts-1-7b-customvoice/ba80df89-2033-4d65-9d88-6930c6ecf7fe.wav)

> **Prompt**: A dairy farm’s emissions are shaped by thousands of small biological processes. One of the biggest happens during digestion, when cows naturally produce methane. Red seaweed offers a promising new approach. Added to feed in carefully measured amounts, its active compounds are designed to interrupt methane formation in the rumen without changing the farmer’s daily routine. The supplement blends into existing rations, while monitoring helps each farm track animal health, productivity, and emissions performance. It’s not a replacement for good nutrition or responsible herd management. It’s another practical tool—helping dairies produce the food people rely on while moving toward a lower-carbon future.

```json
{
  "taskType": "audioInference",
  "taskUUID": "bdbb44ad-7f83-42e0-8e81-ce0db761462c",
  "model": "alibaba:qwen@3-tts-1.7b-customvoice",
  "positivePrompt": "Deliver as a confident, approachable agricultural technology narrator. Sound practical rather than promotional, with clear pacing, warm authority, and subtle emphasis on the key benefits.",
  "speech": {
    "text": "A dairy farm’s emissions are shaped by thousands of small biological processes. One of the biggest happens during digestion, when cows naturally produce methane. Red seaweed offers a promising new approach. Added to feed in carefully measured amounts, its active compounds are designed to interrupt methane formation in the rumen without changing the farmer’s daily routine. The supplement blends into existing rations, while monitoring helps each farm track animal health, productivity, and emissions performance. It’s not a replacement for good nutrition or responsible herd management. It’s another practical tool—helping dairies produce the food people rely on while moving toward a lower-carbon future.",
    "voice": "dylan",
    "language": "English",
    "speed": 1
  }
}
```

---

### text-to-audio (text-to-audio)

[Listen to audio](https://assets.runware.ai/examples/alibaba-qwen3-tts-1-7b-customvoice/64a4c359-02ed-4341-a471-9178549db0c9.wav)

> **Prompt**: Control to lower gallery. Circulation pump three is holding at forty-two hertz. Brine return temperature is stable, and pressure across the west manifold remains within range. Leave the bypass valve where it is. We’ll take the next reading after the tremor train clears. Log this as routine operations, zero two seventeen.

```json
{
  "taskType": "audioInference",
  "taskUUID": "b53f1f15-f439-4efb-a839-2e5f42f8ddc3",
  "model": "alibaba:qwen@3-tts-1.7b-customvoice",
  "positivePrompt": "Speak like a seasoned geothermal plant controller over an internal radio: calm, restrained, slightly hushed, and matter-of-fact, with natural pauses between status updates.",
  "speech": {
    "text": "Control to lower gallery. Circulation pump three is holding at forty-two hertz. Brine return temperature is stable, and pressure across the west manifold remains within range. Leave the bypass valve where it is. We’ll take the next reading after the tremor train clears. Log this as routine operations, zero two seventeen.",
    "voice": "uncle_fu",
    "language": "English"
  }
}
```

---

### text-to-audio (text-to-audio)

[Listen to audio](https://assets.runware.ai/examples/alibaba-qwen3-tts-1-7b-customvoice/eccb4851-0ff6-482d-9eb4-bd07234e6d36.wav)

> **Prompt**: There is another way to return to the earth. Natural organic reduction gently transforms a person’s remains into nutrient-rich soil. In a private vessel, plant materials and naturally occurring microbes support the process over several weeks. The soil is then carefully tested and may be returned to the family for a garden, conservation land, or a place with personal meaning. Every step is managed by licensed professionals, with dignity, transparency, and care. For families seeking a lighter environmental footprint, it is a simple choice rooted in renewal.

```json
{
  "taskType": "audioInference",
  "taskUUID": "42c5becb-5e1b-4786-b97b-3d33a8107f18",
  "model": "alibaba:qwen@3-tts-1.7b-customvoice",
  "positivePrompt": "Speak with gentle confidence and sincere warmth. Keep the delivery calm, grounded, and informative rather than sentimental or promotional. Allow brief pauses after reflective phrases.",
  "speech": {
    "text": "There is another way to return to the earth. Natural organic reduction gently transforms a person’s remains into nutrient-rich soil. In a private vessel, plant materials and naturally occurring microbes support the process over several weeks. The soil is then carefully tested and may be returned to the family for a garden, conservation land, or a place with personal meaning. Every step is managed by licensed professionals, with dignity, transparency, and care. For families seeking a lighter environmental footprint, it is a simple choice rooted in renewal.",
    "voice": "serena",
    "language": "English"
  }
}
```