> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aieev.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Qwen3-TTS

> Multilingual text-to-speech model with custom voice cloning support.

<Info>
  **Model ID:** `qwen/qwen3-tts-customvoice` | **Parameters:** 1.7B | **Released:** 2026-01-22
</Info>

## Overview

Qwen3-TTS-12Hz-1.7B-CustomVoice is a multilingual text-to-speech model from the Qwen3 family. With 1.7 billion parameters, it delivers high-quality speech synthesis across English, Chinese, Japanese, and Korean. The model features 9 preset voices and supports custom voice cloning, making it versatile for various applications. Operating at a 12Hz token rate, it provides efficient audio generation while maintaining natural-sounding output.

<CardGroup cols={3}>
  <Card title="Air API Playground" icon="play" href="https://ap-1.aieev.cloud:3007/models/qwen%2Fqwen3-tts-customvoice">
    Try the model in the playground.
  </Card>

  <Card title="Deploy with Container" icon="container-storage" href="/docs/air-container/deploy-a-container">
    Deploy with AIR Container.
  </Card>

  <Card title="API Usage Guide" icon="book" href="/docs/air-api/api-usage-guide">
    Learn how to use the API.
  </Card>
</CardGroup>

## Pricing

| Input           | Output          |
| --------------- | --------------- |
| \$0 / 1M tokens | \$0 / 1M tokens |

## Key Features

* 1.7B parameter model with high-quality multilingual speech synthesis
* Supports English, Chinese, Japanese, and Korean
* 9 diverse preset voices with custom voice capability
* 12Hz token rate for efficient audio generation
* Built on Qwen3 architecture with strong language understanding

## Use Cases

### Narration Generation

Generate natural voice narration for video content and audiobooks.

**Input Text:**

> Life is like a box of chocolates. You never know what you're gonna get.

### Voice Announcements

Create voice announcements and notifications with various voice styles.

**Input Text:**

> Your order has been confirmed and will be delivered within 3 business days.

### Conversational AI Voice

Generate natural voice responses for chatbots and virtual assistants.

**Input Text:**

> I'd be happy to help you with that! Let me check your account details.

## Parameters

| Parameter         | Type   | Required | Default    | Description                        |
| ----------------- | ------ | -------- | ---------- | ---------------------------------- |
| `input`           | string | Required | -          | Text to convert to speech          |
| `voice`           | enum   | Optional | `"serena"` | Voice preset                       |
| `response_format` | enum   | Optional | `"mp3"`    | Output audio format                |
| `speed`           | number | Optional | 1          | Speech speed multiplier (0.25-4.0) |

## Quick Start

<Steps>
  <Step title="Get your API key">
    Generate an API key from your [AirCloud account](https://aieev.com).
  </Step>

  <Step title="Run the code">
    Replace `YOUR_API_KEY` with your actual key and choose your preferred language.
  </Step>
</Steps>

<CodeGroup>
  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://external.aieev.cloud:5007/ai/api/v1/audio/speech",
      headers={
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json"
      },
      json={
          "model": "qwen/qwen3-tts-customvoice",
          "input": "Hello, welcome to AirCloud!",
          "voice": "serena",
          "response_format": "mp3"
      }
  )

  with open("output.mp3", "wb") as f:
      f.write(response.content)
  ```

  ```bash cURL theme={null}
  curl --request POST \
    --url https://external.aieev.cloud:5007/ai/api/v1/audio/speech \
    --header 'Authorization: Bearer YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
      "model": "qwen/qwen3-tts-customvoice",
      "input": "Hello, welcome to AirCloud!",
      "voice": "serena",
      "response_format": "mp3"
    }' \
    --output output.mp3
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://external.aieev.cloud:5007/ai/api/v1/audio/speech",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
      },
      body: JSON.stringify({
        model: "qwen/qwen3-tts-customvoice",
        input: "Hello, welcome to AirCloud!",
        voice: "serena",
        response_format: "mp3"
      })
    }
  );

  const buffer = await response.arrayBuffer();
  require("fs").writeFileSync("output.mp3", Buffer.from(buffer));
  ```
</CodeGroup>

## Tags

`open-source` `tts` `1.7B` `custom-voice` `multilingual` `multi-voice`