Audition voices
Synthesise the same short line with up to 4 voices — library presets or your own clones — and get a playable clip per voice.
Synchronous. A voice that fails comes back with error beside the others. Free; rate limited per account (429 with retry_after).
Authorization
bearerAuth Typecut API key. Generate one in app.typecut.ai → Settings → API keys. Send as Authorization: Bearer tc_live_….
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/voices/audition" \ -H "Content-Type: application/json" \ -d '{ "voices": [ {} ] }'{
"data": {
"clips": [
{
"voice_id": "2235c634-e4db-4ad6-aa15-066fb69b1c8f",
"clone_id": "803342ec-5f81-40e9-ab1d-d050b5ce27bb",
"name": "string",
"provider": "string",
"model": "string",
"language": "string",
"text": "string",
"audioUrl": "string",
"durationSec": 0,
"warning": "string",
"error": "string"
}
],
"note": "string"
}
}{
"error": {
"type": "string",
"code": "string",
"message": "string"
}
}{
"error": {
"type": "string",
"code": "string",
"message": "string"
}
}{
"error": {
"type": "string",
"code": "string",
"message": "string"
}
}Get a take-to-voice run GET
Where a run is: queued, listening, writing, speaking, ready (url, text_with_tags, heard) or failed (error; credits refunded).
Speak a line into the library POST
Speak ONE line (≤1500 characters) with ONE voice — a library preset or your own clone — and keep it as a library audio asset with word timings.