---
type: AI Model
id: tada
title: Tada TTS API
provider: Tada
description: "Expressive voice cloning from a reference clip, in two sizes. The 3B model trades speed for a more natural read; the 1B is the budget tier."
resource: https://www.pixazo.ai/models/tada
docs_url: https://www.pixazo.ai/models/tada
latest_version: 3B
tags:
  - text-to-speech
  - voice-cloning
  - tada
variants:
  - id: tada-3b-tts
    name: Tada 3B TTS
    version: 3B
    capabilities:
      - Voice Cloning
  - id: tada-1b-tts
    name: Tada 1B TTS
    version: 1B
    capabilities:
      - Voice Cloning
timestamp: 2026-08-21T15:17:22.605Z
---

# Tada TTS API

> Provider: **Tada**
> Source: https://www.pixazo.ai/models/tada

Expressive voice cloning from a reference clip, in two sizes. The 3B model trades speed for a more natural read; the 1B is the budget tier.

## Tada 3B TTS

### Voice Cloning

## Base URL

```
https://gateway.pixazo.ai/tada-3b-tts/v1/text-to-speech
```

## Authentication

All requests require an API key passed via header.

Header

Type

Required

Description

Ocp-Apim-Subscription-Key

string

Yes

Your API subscription key

## Tada 3B TTS generate request - Tada 3B TTS

## Request Code

HTTP Python JavaScript cURL

```
POST https://gateway.pixazo.ai/tada-3b-tts/v1/text-to-speech
Content-Type: application/json
Cache-Control: no-cache
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY

{
  "audio_url": "https://imagesai.appypie.com/7686410/K1D5kDJQ68R3DGvo6aKQ_017731469361782.mp3",
  "prompt": "Under the starlit sky, the storyteller began weaving tales of ancient kingdoms and forgotten heroes.",
  "language": "en"
}
```

```
import requests

url = "https://gateway.pixazo.ai/tada-3b-tts/v1/text-to-speech"
headers = {
    "Content-Type": "application/json",
    "Cache-Control": "no-cache",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
data = {
    "audio_url": "https://imagesai.appypie.com/7686410/K1D5kDJQ68R3DGvo6aKQ_017731469361782.mp3",
    "prompt": "Under the starlit sky, the storyteller began weaving tales of ancient kingdoms and forgotten heroes.",
    "language": "en"
}

response = requests.post(url, json=data, headers=headers)
print(response.json())
```

```
const url = 'https://gateway.pixazo.ai/tada-3b-tts/v1/text-to-speech';

const data = {
  audio_url: 'https://imagesai.appypie.com/7686410/K1D5kDJQ68R3DGvo6aKQ_017731469361782.mp3',
  prompt: 'Under the starlit sky, the storyteller began weaving tales of ancient kingdoms and forgotten heroes.',
  language: 'en'
};

fetch(url, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Cache-Control': 'no-cache',
    'Ocp-Apim-Subscription-Key': 'YOUR_SUBSCRIPTION_KEY'
  },
  body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
```

```
curl -X POST "https://gateway.pixazo.ai/tada-3b-tts/v1/text-to-speech" \
  -H "Content-Type: application/json" \
  -H "Cache-Control: no-cache" \
  -H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \
  --data-raw '{
    "audio_url": "https://imagesai.appypie.com/7686410/K1D5kDJQ68R3DGvo6aKQ_017731469361782.mp3",
    "prompt": "Under the starlit sky, the storyteller began weaving tales of ancient kingdoms and forgotten heroes.",
    "language": "en"
  }'
```

## Output

```
{
  "request_id": "tada-3b-tts_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/tada-3b-tts_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
```

[Try Now](https://api.pixazo.ai/api-details#api=tada-3b-tts&operation=tada-3b-tts-request)

## Webhook (Optional)

Add the `X-Webhook-URL` header to your submit request to receive a `POST` callback when the job completes — no polling required.

**Using curl?** These are HTTP request headers — pass each with `-H`, e.g. `-H "X-Webhook-URL: https://your-server.com/webhook/callback"`. Do not paste them as bare lines, and end every line of a multi-line command with `\`.

### Webhook Headers

Header

Required

Default

Description

`X-Webhook-URL`

Yes (to enable)

—

HTTPS endpoint on your server that will receive the `POST` callback. Must respond `2xx` within a few seconds (process async if needed).

`X-Webhook-Mode`

No

`terminal`

`terminal` — fires once at the final status (`COMPLETED`/`FAILED`/`ERROR`). `sync` — fires on every poll cycle plus the terminal event, and caps the queue’s polling delay at **15s** for tighter progress updates.

### Example: enable webhook

```
X-Webhook-URL: https://your-server.com/webhook/callback
X-Webhook-Mode: terminal
```

### Callback Payload

Your endpoint receives a `POST application/json` with the same shape as the `GET /v2/requests/status/{request_id}` response. Example terminal callback (mode `terminal`):

```
{
  "request_id": "tada-3b-tts_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "tada-3b-tts",
  "error": null,
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/tada-3b-tts_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/output.wav"
    ],
    "media_type": "audio/wav"
  },
  "created_at": "2026-05-22T13:17:32.110Z",
  "updated_at": "2026-05-22 13:19:23",
  "completed_at": "2026-05-22 13:19:23"
}
```

### Failure callback shape

```
{
  "request_id": "tada-3b-tts_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "tada-3b-tts",
  "error": "Description of the error",
  "output": null,
  "created_at": "...",
  "updated_at": "...",
  "completed_at": "..."
}
```

### Delivery semantics

-   **terminal mode (default)** — exactly one `POST` when the request reaches a terminal status. No callback during `PROCESSING`.
-   **sync mode** — `POST` on every status poll (with delay capped at ~15s) plus a final `POST` at terminal status. Use when you want progress updates.
-   **Idempotency** — use `request_id` as your idempotency key. Network retries can deliver the same callback more than once; your handler must tolerate duplicates.
-   **Response** — respond `200 OK` within a few seconds. The queue does not block on slow handlers, but persistent failures may stop further deliveries.
-   **HTTPS required** — plain `http://` URLs are rejected.

## Request Parameters - Tada 3B TTS generate request

Field

Type

Required

Default

Description

audio\_url

string

Yes

—

URL to an audio file containing a voice sample for cloning. Must be accessible publicly.

prompt

string

Yes

—

The text to be synthesized into speech.

language

string

Yes

—

Language code for synthesis (e.g., "en", "es", "fr").

temperature

number

No

0.7

Controls randomness in generation. Lower values produce more deterministic outputs.

top\_p

number

No

0.9

Nucleus sampling parameter. Limits sampling to the most probable tokens whose cumulative probability exceeds this value.

repetition\_penalty

number

No

1.0

Penalizes repeated tokens. Values > 1.0 reduce repetition.

acoustic\_cfg\_scale

number

No

1.5

Controls adherence to the acoustic conditioning (voice clone). Higher values increase fidelity to the source voice.

noise\_temperature

number

No

0.8

Controls the amount of stochastic noise added during generation. Higher values increase variability.

num\_inference\_steps

integer

No

20

Number of refinement steps during audio generation. Higher values improve quality at the cost of speed.

speed\_up\_factor

number

No

1.0

Factor by which to accelerate the output audio. Values > 1.0 speed up playback.

output\_format

string

No

wav

Output audio format. Supported values: "wav", "mp3", "flac".

## Minimum Request

## Response Handling

Common status codes.

Code

Meaning

202

Accepted — Request queued

400

Bad Request

401

Unauthorized

402

Insufficient Balance

403

Forbidden

429

Too Many Requests

500

Internal Server Error

## Error Responses

Queue system errors and model validation errors.

### Queue System Errors

```
// 402 — Insufficient balance
{
  "error": "Insufficient Balance",
  "message": "Your wallet does not have enough balance."
}
```

```
// 400 — Model not found
{
  "error": "Model not found",
  "message": "Model 'tada-3b-tts' not found or is disabled"
}
```

### Error via Status/Webhook

```
{
  "request_id": "tada-3b-tts_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "tada-3b-tts",
  "error": "Description of the error",
  "output": null
}
```

## Retrieving Results

Poll the universal status endpoint to check progress and retrieve results.

### Endpoint

```
GET https://gateway.pixazo.ai/v2/requests/status/{request_id}
Ocp-Apim-Subscription-Key: YOUR_API_KEY
```

## cURL Example

```
curl -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  "https://gateway.pixazo.ai/v2/requests/status/tada-3b-tts_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
```

## Response (Completed)

```
{
  "request_id": "tada-3b-tts_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "tada-3b-tts",
  "error": null,
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/tada-3b-tts_019dxxxx-xxxx/output.ext"
    ],
    "media_type": "application/octet-stream"
  },
  "created_at": "2026-03-31T10:00:00.000Z",
  "updated_at": "2026-03-31T10:00:15.000Z",
  "completed_at": "2026-03-31T10:00:15.000Z"
}
```

## Response Fields

Field

Type

Description

request\_id

string

Unique request identifier

status

string

QUEUED, PROCESSING, COMPLETED, FAILED, or ERROR

model\_id

string

Model that processed the request

error

string|null

Error message if failed

output.media\_url

array

URLs to generated media (R2 CDN)

output.media\_type

string

MIME type of the output

created\_at

string

When request was created

completed\_at

string|null

When request completed

polling\_url

string

Status URL (initial response only)

## Status Values

Status

Description

QUEUED

Request accepted, waiting to be processed

PROCESSING

Being processed by the model

COMPLETED

Done — output contains the result

FAILED

Failed — check error field

ERROR

System error — not charged

## Status Flow

```
QUEUED → PROCESSING → COMPLETED
                    → FAILED
                    → ERROR
```

## Typical Workflow

1.  **Send a generate request** to the API endpoint
2.  **Save the `request_id`** from the response
3.  **Poll** every 5-10 seconds: `GET /v2/requests/status/{request_id}`
4.  **When `status` is `"COMPLETED"`**, download from `output.media_url`

**Tip:** Use `X-Webhook-URL` header to get a callback instead of polling.

## Request Headers

Header

Value

`Content-Type`

`application/json`

`Cache-Control`

`no-cache`

`Ocp-Apim-Subscription-Key`

`YOUR_API_KEY`

## Tada 1B TTS

### Voice Cloning

## Base URL

```
https://gateway.pixazo.ai/tada-1b-tts/v1/text-to-speech
```

## Authentication

All requests require an API key passed via header.

Header

Type

Required

Description

Ocp-Apim-Subscription-Key

string

Yes

Your API subscription key

## Tada 1B TTS generate request - Tada 1B TTS

## Request Code

HTTP Python JavaScript cURL

```
POST https://gateway.pixazo.ai/tada-1b-tts/v1/text-to-speech
Content-Type: application/json
Cache-Control: no-cache
Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY

{
  "audio_url": "https://imagesai.appypie.com/7686410/tTbP36zSI0eJJ1VF3cQ8_017731468841358.mp3",
  "prompt": "The morning news anchor delivered the breaking story with calm authority and measured precision.",
  "language": "en"
}
```

```
import requests

url = "https://gateway.pixazo.ai/tada-1b-tts/v1/text-to-speech"
headers = {
    "Content-Type": "application/json",
    "Cache-Control": "no-cache",
    "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY"
}
data = {
    "audio_url": "https://imagesai.appypie.com/7686410/tTbP36zSI0eJJ1VF3cQ8_017731468841358.mp3",
    "prompt": "The morning news anchor delivered the breaking story with calm authority and measured precision.",
    "language": "en"
}

response = requests.post(url, json=data, headers=headers)
print(response.json())
```

```
fetch('https://gateway.pixazo.ai/tada-1b-tts/v1/text-to-speech', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Cache-Control': 'no-cache',
    'Ocp-Apim-Subscription-Key': 'YOUR_SUBSCRIPTION_KEY'
  },
  body: JSON.stringify({
    audio_url: 'https://imagesai.appypie.com/7686410/tTbP36zSI0eJJ1VF3cQ8_017731468841358.mp3',
    prompt: 'The morning news anchor delivered the breaking story with calm authority and measured precision.',
    language: 'en'
  })
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
```

```
curl -X POST "https://gateway.pixazo.ai/tada-1b-tts/v1/text-to-speech" \
  -H "Content-Type: application/json" \
  -H "Cache-Control: no-cache" \
  -H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \
  --data-raw '{
    "audio_url": "https://imagesai.appypie.com/7686410/tTbP36zSI0eJJ1VF3cQ8_017731468841358.mp3",
    "prompt": "The morning news anchor delivered the breaking story with calm authority and measured precision.",
    "language": "en"
  }'
```

## Output

```
{
  "request_id": "tada-1b-tts_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/tada-1b-tts_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
```

[Try Now](https://api.pixazo.ai/api-details#api=tada-1b-tts&operation=tada-1b-tts-request)

## Webhook (Optional)

Add the `X-Webhook-URL` header to your submit request to receive a `POST` callback when the job completes — no polling required.

**Using curl?** These are HTTP request headers — pass each with `-H`, e.g. `-H "X-Webhook-URL: https://your-server.com/webhook/callback"`. Do not paste them as bare lines, and end every line of a multi-line command with `\`.

### Webhook Headers

Header

Required

Default

Description

`X-Webhook-URL`

Yes (to enable)

—

HTTPS endpoint on your server that will receive the `POST` callback. Must respond `2xx` within a few seconds (process async if needed).

`X-Webhook-Mode`

No

`terminal`

`terminal` — fires once at the final status (`COMPLETED`/`FAILED`/`ERROR`). `sync` — fires on every poll cycle plus the terminal event, and caps the queue’s polling delay at **15s** for tighter progress updates.

### Example: enable webhook

```
X-Webhook-URL: https://your-server.com/webhook/callback
X-Webhook-Mode: terminal
```

### Callback Payload

Your endpoint receives a `POST application/json` with the same shape as the `GET /v2/requests/status/{request_id}` response. Example terminal callback (mode `terminal`):

```
{
  "request_id": "tada-1b-tts_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "tada-1b-tts",
  "error": null,
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/tada-1b-tts_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/output.wav"
    ],
    "media_type": "audio/wav"
  },
  "created_at": "2026-05-22T13:17:32.110Z",
  "updated_at": "2026-05-22 13:19:23",
  "completed_at": "2026-05-22 13:19:23"
}
```

### Failure callback shape

```
{
  "request_id": "tada-1b-tts_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "tada-1b-tts",
  "error": "Description of the error",
  "output": null,
  "created_at": "...",
  "updated_at": "...",
  "completed_at": "..."
}
```

### Delivery semantics

-   **terminal mode (default)** — exactly one `POST` when the request reaches a terminal status. No callback during `PROCESSING`.
-   **sync mode** — `POST` on every status poll (with delay capped at ~15s) plus a final `POST` at terminal status. Use when you want progress updates.
-   **Idempotency** — use `request_id` as your idempotency key. Network retries can deliver the same callback more than once; your handler must tolerate duplicates.
-   **Response** — respond `200 OK` within a few seconds. The queue does not block on slow handlers, but persistent failures may stop further deliveries.
-   **HTTPS required** — plain `http://` URLs are rejected.

## Request Parameters - Tada 1B TTS generate request

Field

Type

Required

Default

Description

audio\_url

string

Yes

—

URL to an audio file containing the voice sample to clone. Must be accessible publicly.

prompt

string

Yes

—

The text to be synthesized into speech.

language

string

Yes

—

Language code for synthesis (e.g., "en", "es", "fr").

temperature

number

No

0.7

Controls randomness in generation. Higher values increase diversity.

top\_p

number

No

0.9

Nucleus sampling parameter. Limits sampling to the most probable tokens.

repetition\_penalty

number

No

1.0

Penalizes repeated tokens. Values >1 reduce repetition.

acoustic\_cfg\_scale

number

No

1.5

Controls adherence to the reference audio. Higher values increase similarity.

noise\_temperature

number

No

0.8

Controls stochasticity in the acoustic model. Higher values add more variation.

num\_inference\_steps

integer

No

20

Number of refinement steps during synthesis. Higher values improve quality.

speed\_up\_factor

number

No

1.0

Factor to accelerate or decelerate speech. Values >1 speed up, <1 slow down.

output\_format

string

No

wav

Output audio format: wav, mp3, ogg, flac.

## Minimum Request

```
{
  "audio_url": "https://imagesai.appypie.com/7686410/tTbP36zSI0eJJ1VF3cQ8_017731468841358.mp3",
  "prompt": "The morning news anchor delivered the breaking story with calm authority and measured precision.",
  "language": "en"
}
```

## Full Request (all options)

```
{
  "audio_url": "https://imagesai.appypie.com/7686410/tTbP36zSI0eJJ1VF3cQ8_017731468841358.mp3",
  "prompt": "The morning news anchor delivered the breaking story with calm authority and measured precision.",
  "language": "en",
  "temperature": 0.6,
  "top_p": 0.9,
  "repetition_penalty": 1.1,
  "acoustic_cfg_scale": 1.6,
  "noise_temperature": 0.9,
  "num_inference_steps": 20,
  "speed_up_factor": 1,
  "output_format": "wav"
}
```

## Response

```
{
  "request_id": "tada-1b-tts_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/tada-1b-tts_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
```

## Request Headers

Header

Value

Content-Type

application/json

Cache-Control

no-cache

Ocp-Apim-Subscription-Key

Your API subscription key

## Response Handling

Common status codes for Tada 1B TTS generate request.

Code

Meaning

202

Accepted — Request queued

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

429

Too Many Requests

500

Internal Server Error

## Error Responses

Queue system errors and model validation errors.

### Queue System Errors

```
// 402 — Insufficient balance
{
  "error": "Insufficient Balance",
  "message": "Your wallet does not have enough balance."
}
```

```
// 400 — Model not found
{
  "error": "Model not found",
  "message": "Model 'tada-1b-tts' not found or is disabled"
}
```

### Error via Status/Webhook

```
{
  "request_id": "tada-1b-tts_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "tada-1b-tts",
  "error": "Description of the error",
  "output": null
}
```

## Retrieving Results

Poll the universal status endpoint to check progress and retrieve results.

### Endpoint

```
GET https://gateway.pixazo.ai/v2/requests/status/{request_id}
Ocp-Apim-Subscription-Key: YOUR_API_KEY
```

## cURL Example

```
curl -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  "https://gateway.pixazo.ai/v2/requests/status/tada-1b-tts_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
```

## Response (Completed)

```
{
  "request_id": "tada-1b-tts_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "tada-1b-tts",
  "error": null,
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/tada-1b-tts_019dxxxx-xxxx/output.ext"
    ],
    "media_type": "application/octet-stream"
  },
  "created_at": "2026-03-31T10:00:00.000Z",
  "updated_at": "2026-03-31T10:00:15.000Z",
  "completed_at": "2026-03-31T10:00:15.000Z"
}
```

## Response Fields

Field

Type

Description

request\_id

string

Unique request identifier

status

string

QUEUED, PROCESSING, COMPLETED, FAILED, or ERROR

model\_id

string

Model that processed the request

error

string|null

Error message if failed

output.media\_url

array

URLs to generated media (R2 CDN)

output.media\_type

string

MIME type of the output

created\_at

string

When request was created

completed\_at

string|null

When request completed

polling\_url

string

Status URL (initial response only)

## Status Values

Status

Description

QUEUED

Request accepted, waiting to be processed

PROCESSING

Being processed by the model

COMPLETED

Done — output contains the result

FAILED

Failed — check error field

ERROR

System error — not charged

## Status Flow

```
QUEUED → PROCESSING → COMPLETED
                    → FAILED
                    → ERROR
```

## Typical Workflow

1.  **Send a generate request** to the API endpoint
2.  **Save the `request_id`** from the response
3.  **Poll** every 5-10 seconds: `GET /v2/requests/status/{request_id}`
4.  **When `status` is `"COMPLETED"`**, download from `output.media_url`

**Tip:** Use `X-Webhook-URL` header to get a callback instead of polling.