---
title: "Preload a cloned TTS voice into the system"
method: POST
path: "/v2/tts/voices/custom/preload"
---

# Preload a cloned TTS voice into the system

`POST /v2/tts/voices/custom/preload`

This endpoint allows you to preload a custom cloned voice into the system's before using it. You only need to preload the voice only once. You may preload it once your application starts to reduce any latency if you use the Real-Time APIs.

## Request body

- PreloadVoiceRequest
  - `voiceId` string, required — The unique identifier of the custom cloned voice to preload into the system

## Response `200`

Voice successfully preloaded

- PreloadVoiceResponse
  - `success` boolean
  - `message` string
  - `data` unknown[]
    - unknown

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Voice not found
- `500` — Server Side 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)