curl -X POST "https://api.telzino.com/v1/custom-voices" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-F "clip=@/path/to/sample.wav" \
-F "name=Jane (front desk)" \
-F "language=en" \
-F "consent=true" \
-F "organizationId=ORG_UUID"
{
"data": {
"id": "cloned-3f2a...",
"name": "Jane (front desk)",
"description": "Custom cloned voice",
"provider": "cartesia",
"custom": true,
"language": "en"
}
}
Custom Voices
Create Custom Voice
Clone a voice from an audio sample and add it to an organization
POST
/
v1
/
custom-voices
curl -X POST "https://api.telzino.com/v1/custom-voices" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-F "clip=@/path/to/sample.wav" \
-F "name=Jane (front desk)" \
-F "language=en" \
-F "consent=true" \
-F "organizationId=ORG_UUID"
{
"data": {
"id": "cloned-3f2a...",
"name": "Jane (front desk)",
"description": "Custom cloned voice",
"provider": "cartesia",
"custom": true,
"language": "en"
}
}
Clones a voice from a short audio sample via Cartesia and stores it as an
organization-scoped custom voice. The returned voice can then be assigned to any
agent in the organization like a built-in Cartesia voice.
The request is
multipart/form-data (it carries an audio file).
Form Fields
file
required
The audio sample to clone. Supported types:
mp3, wav, flac, ogg, webm. Maximum size 4 MB. A 10–30 second clip works best.string
required
A name for the voice (unique within the organization).
string
default:"en"
Clone language. One of Cartesia’s supported codes:
en, fr, de, es, pt, zh, ja, hi, it, ko, nl, pl, ru, sv, tr, tl, bg, ro, ar, cs, el, fi, hr, ms, sk, da, ta, uk, hu, no, vi, bn, th, he, ka, id, te, gu, kn, ml, mr, pa. Stored with the voice and applied as the agent’s voice_settings.language.string
required
Must be the string
"true" to attest you have the right and consent to clone this voice.string
required
The organization the voice belongs to.
string
Optional description.
curl -X POST "https://api.telzino.com/v1/custom-voices" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-F "clip=@/path/to/sample.wav" \
-F "name=Jane (front desk)" \
-F "language=en" \
-F "consent=true" \
-F "organizationId=ORG_UUID"
Response
Returns the created voice as a voice option (provider: "cartesia", custom: true). Its id is the Cartesia voice id to store in an agent’s voiceSettings.voice_id.
{
"data": {
"id": "cloned-3f2a...",
"name": "Jane (front desk)",
"description": "Custom cloned voice",
"provider": "cartesia",
"custom": true,
"language": "en"
}
}
Errors
| Status | Meaning |
|---|---|
400 | Missing consent, missing/empty clip, unsupported audio type, clip over 4 MB, or unsupported language |
403 | The custom voices feature is not enabled for this organization |
404 | Organization not found or not accessible |
409 | A voice with this name already exists in the organization |
502 | Voice cloning failed upstream (Cartesia) |