---
title: "Add a new voice to the model"
method: POST
path: "/waves/v1/lightning-large/add_voice"
tags: ["Voice Cloning"]
---

# Add a new voice to the model

`POST /waves/v1/lightning-large/add_voice`

**Deprecated** — use `POST /waves/v1/voice-cloning` instead. The new
endpoint defaults to `lightning-v3.1`, supports optional metadata,
and returns pre-generated sample clips. This endpoint only clones
onto `lightning-large` and the resulting voices do not work on
`lightning-v3.1` (returns an empty WAV). Kept live for backward
compatibility; new integrations should migrate.

## Response `200`

Voice clone created successfully

- object
  - `message` string — Message if the voice clone was created successfully.
  - `data` object
    - `voiceId` string, required — Unique Voice ID.
    - `model` string, required — Model used to generate the voice.
    - `status` string, required — Status of the voice creation.

## Other responses

- `400` — Bad request or limit exceeded
- `401` — Unauthorized
- `500` — Server error occurred

## Changes

- **2026-03-14** `27f8a033c1bb` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/smallest-inc/apis/waves-api-2/changes/waves/v1/lightning-large/add_voice/post.md)

---

[API](https://skmtc.dev/smallest-inc/apis/waves-api-2.md) · [All operations](https://skmtc.dev/smallest-inc/apis/waves-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/smallest-inc/waves-api-2/revisions/8d066f7df4b0/schema)