Custom Voices
Clone a voice from one reference clip and reuse the returned voice_id in TTS, streaming TTS, or Voice Agent calls. API creation is enterprise-gated; console-created custom voices can still be used by ID.
curl -X POST http://localhost:18645/v1/custom-voices -H "Authorization: Bearer $API_KEY" -F "name=my-voice" -F "gender=female" -F "accent=american" -F "language=en" -F "file=@reference.mp3"| Rule | Official behavior |
|---|---|
| Upload field | Use singular file, not repeated samples. |
| Reference length | Max 120 seconds; 90-120 seconds is recommended for best quality. |
| Availability | Currently United States only, excluding Illinois. |
| Scope | Custom voices are team-scoped and do not appear in GET /v1/tts/voices. |
| Limits | Team voice count is limited; delete unused voices when rotating references. |