Create Voice | Speechify API

Create a personal (cloned) voice for the user

Authentication

AuthorizationBearer

Enter your API key with the Bearer prefix, e.g. ‘Bearer sk_…’.

Headers

Speechify-VersionstringOptional

Idempotency-KeystringOptional<=255 characters

A client-generated key (an opaque string, max 255 chars) that makes a side-effect POST safe to retry: the server runs the operation exactly once and replays the first response (its status and body) for 24 hours. Reusing a key with a different request body, or while the first request is still in flight, returns 409 idempotency_conflict. A replayed response carries the Idempotent-Replayed: true header.

A client-generated key (an opaque string, max 255 chars) that makes a side-effect POST safe to retry: the server runs the operation exactly once and replays the first response (its status and body) for 24 hours. Reusing a key with a different request body, or while the first request is still in flight, returns `409 idempotency_conflict`. A replayed response carries the `Idempotent-Replayed: true` header.

Request

This endpoint expects a multipart form with multiple files.

namestringRequired

Name of the personal voice

localestringOptionalDefaults to en-US

Native language (locale) of the personal voice (e.g. en-US, es-ES, etc.)

genderenumRequired

Gender marker for the personal voice male GenderMale female GenderFemale not_specified GenderNotSpecified

Allowed values:

samplefileRequired

Audio sample file

avatarfileOptional

Avatar image file

Response headers

X-Request-IDstring

Unique identifier for this request, present on every response (2xx and non-2xx alike). If the caller sends an X-Request-ID request header the server echoes it back (sanitized and length-capped) so one logical request can be traced end-to-end; otherwise the server generates a fresh value. Log it on every response and quote it in support requests - it is the stable handle that ties your observation to Speechify’s server-side logs, and it matches the request_id field in the error envelope.

Unique identifier for this request, present on every response (2xx and non-2xx alike). If the caller sends an `X-Request-ID` request header the server echoes it back (sanitized and length-capped) so one logical request can be traced end-to-end; otherwise the server generates a fresh value. Log it on every response and quote it in support requests - it is the stable handle that ties your observation to Speechify's server-side logs, and it matches the `request_id` field in the error envelope.

Response

A created voice

display_namestring

genderenum

localestring

idstring

modelslist of objects

typeenum

avatar_imagestring or null

preview_audiostring or null

tagslist of strings or null

Errors

400

Bad Request Error

401

Unauthorized Error

402

Payment Required Error

403

Forbidden Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

502

Bad Gateway Error

503

Service Unavailable Error

1	from speechify import Speechify
2
3	client = Speechify(
4	token="YOUR_TOKEN_HERE",
5	)
6
7	client.voices.create(
8	sample="example_sample",
9	avatar="example_avatar",
10	)

1	{
2	"display_name": "Example name",
3	"gender": "male",
4	"locale": "en-US",
5	"id": "scott",
6	"models": [
7	{
8	"languages": [],
9	"name": "simba-english"
10	}
11	],
12	"type": "shared",
13	"avatar_image": "example",
14	"preview_audio": "example",
15	"tags": [
16	"example"
17	]
18	}