---
title: "Text to MP3 voiceover (signed link)."
method: POST
path: "/tts"
tags: ["Tools"]
---

# Text to MP3 voiceover (signed link).

`POST /tts`

## Request

- Base URL: `https://wowreveal.com/api/v1`
- URL: `https://wowreveal.com/api/v1/tts`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `text` string, required
  - `voiceId` string, required
  - `language` 'en' | 'es' | 'pt' | 'fr' | 'de' | 'it' | 'ru' | 'hi' | 'ar'
  - `speed` number

## Response `200`

Success

- object
  - `file` object
    - `url` string
  - `creditsCharged` integer
  - `balance` integer

## Other responses

- `400`: Invalid request (VALIDATION_ERROR and other 400 codes).
- `401`: Missing or revoked API key (INVALID_API_KEY).
- `403`: The plan has no API access, or the account is blocked.
- `429`: Rate limit (RATE_LIMITED) — see the Retry-After header.

---

[API](https://skmtc.dev/wowreveal/apis/wowreveal-rest-api.md) · [All operations](https://skmtc.dev/wowreveal/apis/wowreveal-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wowreveal/apis/wowreveal-rest-api/revisions/cb44d779f713?raw)