API Reference
  1. Recordings

Regenerate a recording from text

patch
https://api.emaktalk.com/api/v1/recordings//generate

Re-synthesizes an existing recording and overwrites its audio in place; the call is billable. Nothing checks whether the recording is in use first, so this can replace audio that a live phone menu is playing. Changing name mints a new filename and deletes the old audio, while keeping or omitting it reuses the existing file, and the recording's text, speed, voice and instructions are always overwritten.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Identifier of the recording to re-synthesize in place.

Body Params
tts
object
required

The synthesis request; it must contain tts.input.

string
required

The text to speak; omitting it is a 400.

string

Speech model to use; defaults to gpt-4o-mini-tts.

string

Voice to speak in; defaults to alloy.

number

Speaking rate; defaults to 1.0.

string

Requested audio format; defaults to wav, and the recording is stored as WAV either way.

string

Optional style instructions for the delivery.

string

New recording name; changing it mints a new filename and deletes the old audio, while keeping or omitting it reuses the existing file.

string

Description; defaults to TTS: followed by the first 100 characters of the input text.

Responses
200

The recording was re-synthesized and updated.

401

Missing or invalid API key.

Updated about 6 hours ago

Did this page help you?
Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 6 hours ago

Did this page help you?