Voices
Staffify has 86 voices across 13 languages. Use a voice's Name in the voice field when creating or updating an agent. Voices are language-specific -- using a voice from the wrong language returns a 400 error.
/v1/voicesoptional: ?language=en-US# All voices curl "https://api.staffifyai.com/v1/voices" \ -H "Authorization: Bearer sfy_live_YOUR_KEY" # Filter to one language curl "https://api.staffifyai.com/v1/voices?language=nl-NL" \ -H "Authorization: Bearer sfy_live_YOUR_KEY"
Response — without ?language= (grouped by language)
{
"languages": ["en-US", "nl-NL", "de-DE"],
"voices": {
"en-US": [
{ "name": "Sarah", "gender": "female", "description": "Clear and professional" },
{ "name": "Michael", "gender": "male", "description": "Professional and clear" }
],
"nl-NL": [
{ "name": "Marieke", "gender": "female", "description": "Kalm en verfijnd" }
]
}
}Response — with ?language=en-US (flat array)
{
"language": "en-US",
"voices": [
{ "name": "Sarah", "gender": "female", "description": "Clear and professional" },
{ "name": "Michael", "gender": "male", "description": "Professional and clear" }
]
}?language= param accepts prefix matching (e.g. en matches en-US and en-GB) and is case-insensitive.Clear and professional
Warm and friendly
Energetic and welcoming
Sophisticated and calm
Natural and friendly
Expressive and engaging
Warm and conversational
Modern and expressive
Deep and authoritative
Professional and clear
Warm and reassuring
Natural and conversational
Professional and clear
Warm and trustworthy
Confident and clear
Natural and friendly
Young and energetic
Warm and conversational
Elegant and refined
Friendly and approachable
Professional and clear
Young and friendly
Modern and engaging
Calm and professional
Confident and articulate
Warm and personable
Clara y profesional
Energética y acogedora
Joven y enérgica
Cálida y amigable
Suave y reconfortante
Profesional y claro
Cálido y reconfortante
Profesional y claro
Profundo y autoritario
Claire et professionnelle
Naturelle et professionnelle
Mature et professionnelle
Claire et articulée
Naturel et confiant
Naturel et professionnel
Profond et autoritaire
Amical et accessible
Chaleureux et rassurant
Clair et professionnel
Klar und professionell
Warm und einladend
Selbstbewusst und deutlich
Natürlich und freundlich
Jung und energisch
Klar und professionell
Natürlich und professionell
Freundlich und zugänglich
Natürlich und professionell
Tief und autoritär
Freundlich und zugänglich
Calda e accogliente
Naturale e amichevole
Calda e conversazionale
Giovane ed energica
Giovane ed energico
Naturale e professionale
Profondo e autorevole
Amichevole e accessibile
Giovane ed energico
Kalm en verfijnd
Natuurlijk en vriendelijk
Warm en gespreksmatig
Natuurlijk en professioneel
Natuurlijk en professioneel
Calorosa e amigável
Profissional e claro
Naturalna i przyjazna
Ciepła i profesjonalna
Profesjonalny i wyraźny
Naturlig och vänlig
Varm och professionell
Professionell och tydlig
Naturlig og venlig
Professionel og klar
Naturlig og vennlig
Varm og profesjonell
Profesjonell og tydelig
Luonnollinen ja ystävällinen
Lämmin ja ammattimainen
Ammattimainen ja selkeä
Node.js: fetch voices and configure an agent
const KEY = process.env.STAFFIFY_API_KEY;
// Get Dutch voices
const { voices } = await fetch(
'https://api.staffifyai.com/v1/voices?language=nl-NL',
{ headers: { Authorization: `Bearer ${KEY}` } }
).then(r => r.json());
const femaleVoices = voices.filter(v => v.gender === 'female');
// ['Marieke', 'Nienke', 'Anouk']
// Create an agent using the first female Dutch voice
await fetch('https://api.staffifyai.com/v1/agents', {
method: 'POST',
headers: { Authorization: `Bearer ${KEY}`, 'Content-Type': 'application/json' },
body: JSON.stringify({
name: 'Dutch Support Agent',
server_url: 'https://your-server.com/call-handler',
language: 'nl-NL',
voice: femaleVoices[0].name, // 'Marieke'
}),
});Voice + language must match
Each voice belongs to exactly one language. Using a voice name with the wrong language returns 400 Bad Request with a message pointing you to GET /v1/voices?language=<lang>.
Preview voices before deploying at console.staffifyai.com.