Upload a recording

post

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

Uploads an audio file and stores it as a recording on your account, converting it to WAV. For an ordinary upload the audio is also transcribed automatically: the transcript is stored in tts_text and becomes the description when you do not supply one. Sending tts_ssml instead marks the recording as text-to-speech and skips that transcription. Note that a successful upload answers 200, not 201.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

name

string

required

Recording name; it is cleaned up before storage, and a name that cleans down to nothing is rejected with 400.

file

string

required

The audio, either as a base64 string (optionally a data:<mime>;base64, URI) or as an object with base64 data plus optional name and type; it is converted to WAV on the server.

domain

string

Domain name — not an identifier — of the account to store the recording under; it is resolved by name, so send your own domain or omit the field to use your current account.

description

string

Description, truncated to 200 characters on a word boundary; defaults to the transcript, the text-to-speech text, or the name.

tts_ssml

string | null

Speech markup; sending it marks the recording as text-to-speech and skips the automatic transcription.

tts_text

string | null

Full spoken text, stored for text-to-speech recordings; for ordinary uploads the automatic transcript is stored here instead.

tts_provider

string | null

Label for the text-to-speech provider used.

tts_voice

string | null

Label for the text-to-speech voice used.

tts_editor_state

object | null

Opaque Speech Studio editor state, stored as-is.

Responses

200

The recording was created — note the success status here is 200, not 201.

401

Missing or invalid API key.

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

400The name is empty or invalid, the domain could not be resolved, file is missing or malformed, the audio could not be decoded, or the upload to storage failed.

403You are not an administrator of the account you named.