Add Voice (Deprecated) | Smallest AI Docs

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.

**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.

Authentication

AuthorizationBearer

Header authentication of the form Bearer <token>

Request

This endpoint expects a multipart form containing a file.

displayNamestringRequired

Display name for the voice clone.

filefileRequired

Audio file to create voice clone from.

Response

Voice clone created successfully

messagestring

Message if the voice clone was created successfully.

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error

1	import requests
2
3	url = "https://api.smallest.ai/waves/v1/lightning-large/add_voice"
4
5	files = { "file": "open('string', 'rb')" }
6	payload = { "displayName": "string" }
7	headers = {"Authorization": "Bearer <BearerAuth>"}
8
9	response = requests.post(url, data=payload, files=files, headers=headers)
10
11	print(response.json())

1	{
2	"message": "string",
3	"data": {
4	"voiceId": "string",
5	"model": "string",
6	"status": "string"
7	}
8	}