---
title: "Create TTS history"
method: POST
path: "/v2/tts/histories"
---

# Create TTS history

`POST /v2/tts/histories`

Create a new TTS history entry for a generated audio clip.

## Request body

- CreateTtsHistoryRequest
  - `ttsVoiceId` string, uuid, required — TTS voice identifier
  - `script` string, required — Text to be synthesized. Must contain real Arabic or English text.
  - `config` object — Optional voice generation configuration
    - `speed` number — Speech speed multiplier
    - `expressiveness` number — Speech expressiveness level
  - `voiceDictionaryIds` string[] — Optional list of voice dictionary identifiers
  - `apiKey` string, uuid, required — API key identifier (used for API key authorization)

## Response `200`

History created successfully.

- CreateTtsHistoryResponse
  - `success` boolean
  - `message` string
  - `messageKey` string
  - `data` unknown[]
    - unknown

## Other responses

- `400` — Validation error.
- `404` — Resource 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)