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

# Quickdial

> Text-to-speech service implementation using Quickdial's real-time CPU-optimized TTS API

export const CommunityMaintained = ({maintainer, maintainerUrl, repo}) => <Note>
    <strong>Community-maintained integration.</strong> This service is built and
    maintained by{" "}
    <a href={maintainerUrl} target="_blank" rel="noreferrer">
      {maintainer}
    </a>
    . Pipecat does not test or officially support it. Please report issues and
    request changes on the{" "}
    <a href={repo} target="_blank" rel="noreferrer">
      source repository
    </a>
    . Learn more about{" "}
    <a href="/api-reference/server/services/community-integrations">
      community integrations
    </a>
    .
  </Note>;

<CommunityMaintained maintainer="Quickdial AI" maintainerUrl="https://github.com/samay-ai" repo="https://github.com/samay-ai/pipecat-quickdial" />

## Overview

`QuickdialTTSService` generates speech from text using [Quickdial](https://quickdial.ai/)'s
real-time text-to-speech API. It extends Pipecat's `TTSService` and pushes
`TTSAudioRawFrame` audio into the pipeline. Quickdial runs CPU-optimized engines
(no GPU), streams audio as it's generated, and is priced per character.

<CardGroup cols={2}>
  <Card title="Source Repository" icon="github" href="https://github.com/samay-ai/pipecat-quickdial">
    Source code, examples, and issues for the Quickdial integration
  </Card>

  <Card title="PyPI Package" icon="cube" href="https://pypi.org/project/pipecat-quickdial/">
    The `pipecat-quickdial` package on PyPI
  </Card>

  <Card title="Quickdial" icon="book" href="https://quickdial.ai/">
    Learn more about Quickdial and get an API key
  </Card>

  <Card title="Docs" icon="file-lines" href="https://quickdial.ai/docs">
    Quickdial API reference (REST + WebSocket)
  </Card>
</CardGroup>

## Installation

This is a community-maintained package distributed separately from `pipecat-ai`:

```bash theme={null}
uv add pipecat-quickdial
```

## Prerequisites

1. **Quickdial account** — sign up at [web.quickdial.ai](https://web.quickdial.ai) (1000 free credits, no card required).
2. **API key** — create one in the dashboard.

### Required environment variables

```bash theme={null}
QUICKDIAL_API_KEY=qtts_live_your_key
```

## Configuration

| Parameter     | Type   | Default                     | Description                                            |
| ------------- | ------ | --------------------------- | ------------------------------------------------------ |
| `api_key`     | `str`  | `QUICKDIAL_API_KEY` env var | Your Quickdial API key.                                |
| `voice`       | `str`  | `"alba"`                    | Voice name (see the voice catalog / `GET /v1/voices`). |
| `base_url`    | `str`  | `https://api.quickdial.ai`  | API base URL.                                          |
| `sample_rate` | `int`  | `24000`                     | Output sample rate (Hz).                               |
| `params`      | `dict` | `None`                      | Optional model knobs (e.g. `temperature`, `speed`).    |

## Usage

```python theme={null}
import os

from pipecat_quickdial import QuickdialTTSService

tts = QuickdialTTSService(
    api_key=os.getenv("QUICKDIAL_API_KEY"),
    voice="alba",
)

# ...add `tts` to your Pipecat Pipeline([...])
```

## Additional resources

* [pipecat-quickdial on GitHub](https://github.com/samay-ai/pipecat-quickdial) — source, example, and issues
* [Quickdial API docs](https://quickdial.ai/docs)