Skip to main content
POST
/
v1
/
voices
/
preview
curl -X POST "https://api.telzino.com/v1/voices/preview" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "voiceId": "79a125e8-cd45-4c13-8a67-188112f4dd22",
    "text": "Hello, thank you for calling. How can I help you?"
  }'

{
  "success": true,
  "audioData": "UklGRiQAAABXQVZFZm10IBAAAAABAAEA..."
}
Generates a base64-encoded audio sample for a given voice ID. Use this to let users hear how a voice sounds before assigning it to an agent.

​
Request Body

​
voiceId
string
required
The voice ID to preview. Get available IDs from the List Voices endpoint.
​
text
string
Custom text to speak (1–500 characters). If omitted, a default greeting is used.
curl -X POST "https://api.telzino.com/v1/voices/preview" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "voiceId": "79a125e8-cd45-4c13-8a67-188112f4dd22",
    "text": "Hello, thank you for calling. How can I help you?"
  }'

{
  "success": true,
  "audioData": "UklGRiQAAABXQVZFZm10IBAAAAABAAEA..."
}

​
Response Fields

FieldTypeDescription
successbooleanWhether the preview was generated successfully
audioDatastringBase64-encoded audio data
This endpoint generates previews for Cartesia voice IDs only. Minimax voices are not supported by this endpoint — use the static previewUrl field returned by the List Voices endpoint instead.Voice previews are generated by the upstream TTS provider (Cartesia). In rare cases, the provider may return a 502 or 503 error due to temporary availability issues.