Create Instant Voice Clone

POST 
https://api.knoxstudio.ai/v1/voices/add

IVC create. name and files are required. Sample uploads stay under 210MB wrapping. Not billed. Guide: Voices.

Request

Request Headers

Name	Type	Required	Description
Authorization	String	Yes	Bearer <token> Knox API key. xi-api-key is also accepted.
Content-Type	String	Yes	multipart/form-data

Request Body

Name	Type	Required	Description
name	String	Yes	Voice name.
files	File	Yes	Audio recordings used for cloning. Repeat the field for multiple files.
description	String	No	Optional description; forwarded.
labels	String	No	JSON object or JSON string.

cURL Example

curl -X POST https://api.knoxstudio.ai/v1/voices/add \
     -H "Authorization: Bearer $KNOXCHAT_API_KEY" \
     -F "name=Studio Narrator" \
     -F "files=@sample1.wav" \
     -F "files=@sample2.wav"

Response

Success Response (200)

Created voice JSON, including voice_id.

Error Responses

Validation uses HTTP 422:

{
  "detail": [
    {
      "loc": ["body", "field"],
      "msg": "…",
      "type": "value_error"
    }
  ]
}

Other errors use { "detail": "message" }.

Status	When
400	WebSocket path called without Upgrade: websocket.
401	Missing or invalid API key.
402	Insufficient credits.
403	Token is not allowed to use this model.
404	Resource not found.
422	Validation error.
429	Rate limit exceeded.
500	Internal server error.