API referenceVoices
Get a take-to-voice run
Where a run is: queued, listening, writing, speaking, ready (url, text_with_tags, heard) or failed (error; credits refunded).
Free. The call that finds the tags written also speaks the line, so it can take a few seconds.
Authorization
bearerAuth AuthorizationBearer <token>
Typecut API key. Generate one in app.typecut.ai → Settings → API keys. Send as Authorization: Bearer tc_live_….
In: header
Path Parameters
performanceId*string
Format
uuidResponse Body
application/json
application/json
application/json
curl -X GET "https://example.com/voices/perform/497f6eca-6276-4993-bfeb-53cbbbba6f08"{
"data": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"status": "queued",
"step_label": "string",
"heard": [
{
"start": 0,
"end": 0,
"text": "string"
}
],
"text_with_tags": "string",
"tags_fallback": true,
"note": "string",
"url": "string",
"asset_id": "b4695157-0d1d-4da0-8f9e-5c53149389e4",
"duration_sec": 0,
"credits": 0,
"error": "string",
"next": "string"
}
}{
"error": {
"type": "string",
"code": "string",
"message": "string"
}
}{
"error": {
"type": "string",
"code": "string",
"message": "string"
}
}Take to voice POST
Listen to a recorded take (words and timings, sounds, mood), write it as Drama 3 expression tags and pauses, and speak it in a chosen voice.
Audition voices POST
Synthesise the same short line with up to 4 voices — library presets or your own clones — and get a playable clip per voice.