---
title: "Preview TTS voice"
method: POST
path: "/v2/tts/voices/preview"
---

# Preview TTS voice

`POST /v2/tts/voices/preview`

Generate a short preview clip for a TTS voice.

## Query parameters

- `projectId` string, required

## Request body

- TtsVoicePreviewRequest
  - `audioUrl` string, uri, required — URL of the uploaded voice sample
  - `audioTranscription` string, required — Transcription of the uploaded audio sample
  - `language` 'en' | 'ar', required — Language of the preview voice
  - `dialectId` string, uuid, required — Dialect identifier (required for preview)
  - `text` string, required — Text to be synthesized using the preview voice

## Response `200`

Preview generated successfully.

- TtsVoicePreviewResponse
  - `success` boolean
  - `message` string
  - `messageKey` string
  - `data` object
    - `audioUrl` string, uri

## Other responses

- `400` — Validation error.
- `404` — Voice not found.
- `500` — Internal server error.

---

[API](https://skmtc.net/tryhamsa/apis/hamsa-api.md) · [All operations](https://skmtc.net/tryhamsa/apis/hamsa-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryhamsa/hamsa-api/versions/ecbeb5d8dc13/schema)