Skip to the content.

Create audio file

Generate a TTS audio asset or upload an existing audio file.

Endpoint: POST https://<base>/api/v2/CreateAudioFile.php

Creates an audio asset in cd_wav so it can be referenced by content* parameters in MakeTTSCall and other voice routines. Three input modes:

You can also pass raw bytes in the request body (Content-Type: audio/...) when you cannot do multipart or base64.

Authentication

Token authentication required. See Authentication.

Request

tsid — type: string — required

Token for the account.

text — type: string

Text to synthesize. Required for TTS mode (mutually exclusive with file uploads / base64).

voice — type: string

Voice id: exactly the cdwv_short returned by GetTTSVoices (e.g. Google|pt-BR-Wavenet-A, fad). Defaults to fad when only text is provided. With text, a voice outside the account’s list is rejected with code 209; letter case is not significant.

encoding — type: string

Encoding of text: UTF-8, 2UTF-8, ASCII. Default is ISO-8859-1 for form requests, UTF-8 for JSON.

rate — type: integer

TTS speech rate, range -6 to 6.

audio64 — type: string

Base64-encoded audio. Accepts data:audio/<type>;base64,<...> data-URIs and url-safe base64. Auto-detects the file extension via finfo.

audio — type: file

Multipart file field. The endpoint also accepts any other field name and uses the first valid file.

name — type: string

Friendly name for the asset (cd_wav.cdw_name).

name_up — type: string

Filename to use when storing the upload. Auto-detected from the data-URI / mime type when omitted. Alias nome_up is accepted.

Rules applied to the name, in every input mode (file upload, audio64, raw body):

With audio64, the audio type is detected from the content: a name_up without extension receives the detected one, and an extension different from the detected type is replaced by it.

type — type: string

Asset type: tts, upload, rec, or ttsvar (TTS template with placeholders). Inferred from the input mode when omitted.

cdg_id — type: integer

Optional asset group id (cd_wav_group.cdg_id).

speed — type: number — default: 1

Speed factor for uploads. 1 = no change, <1 = slower, >1 = faster. Use a dot as the decimal separator, from 0.25 to 4 (up to 4 decimal places, e.g. 0.9 or 1.15). Any other value makes the upload fail with an error.

delsilence — type: integer

Silence trimming for uploads: 1 strips initial silence, 2 strips trailing silence, 3 strips both.

incsilence — type: number

Seconds of silence to insert at the beginning of an upload, from 0 to 30, with a dot as the decimal separator (e.g. 0.5 for half a second). 0 or empty inserts nothing. Any other value makes the upload fail with an error.

mp3 — type: string

Pass no to skip MP3 generation (the WAV is always generated). Default produces both.

ttswrt — type: string

Pass 1 to mark the asset as permanent (does not expire after one day). Otherwise the asset expires after one day if it is TTS-generated.

expires — type: string

Override the expiration date (YYYY-MM-DD). Default: tomorrow for TTS without ttswrt=1; +5 years otherwise.

dis — type: string

Pass NO to hide the asset from the audio list dashboard.

Request example

```bash curl (TTS) curl -X POST ‘https:///api/v2/CreateAudioFile.php’
-H ‘Content-Type: application/json’
-d ‘{ “tsid”: “YOUR_TSID”, “text”: “Hello, this is a test message.”, “voice”: “Google|pt-BR-Wavenet-A”, “name”: “test message”, “ttswrt”: “1”, “encoding”: “UTF-8” }’


```bash curl (file upload)
curl -X POST 'https://<base>/api/v2/CreateAudioFile.php' \
  -F 'tsid=YOUR_TSID' \
  -F 'audio=@/path/to/voice.mp3' \
  -F 'name=Welcome message' \
  -F 'ttswrt=1'

```bash curl (base64) curl -X POST ‘https:///api/v2/CreateAudioFile.php’
-H ‘Content-Type: application/json’
-d ‘{ “tsid”: “YOUR_TSID”, “audio64”: “data:audio/mp3;base64,SUQzBAAAAAAAA…”, “name_up”: “voicemail.mp3”, “name”: “Voicemail”, “ttswrt”: “1” }’

## Response
```json 200 OK
{
  "return": {
    "status": "OK",
    "status_code": "0",
    "cdw_file": "tf12345",
    "cdw_file_test": "",
    "cdw_name": "test message",
    "cdw_sec ": "5",
    "cdw_expires ": "2031-05-06",
    "cdw_type ": "tts"
  }
}

Error codes

Code status Cause
205 not allowed executable file / Virus infected file The uploaded file is rejected (executable / ClamAV positive).
209 Voice not found With text, voice is not one of the voices returned by GetTTSVoices for the account. Nothing was created.
210 TTS ElevenLabs not permitted in CreateAudioFile ElevenLabs voices are not allowed in this endpoint.
500 internal error The voice list could not be read (temporary failure). Nothing was created; repeat the request.
220 no audio or text None of text, file upload, audio64, nor raw body provided.
221 upload error code=N PHP UPLOAD_ERR_* — usually 2 (MAX_FILE_SIZE) or 7 (cannot write to disk).
222 no name_up File uploaded without a filename and name_up was not provided.
223 size up=N Upload smaller than 100 bytes.
224 invalid base64 in audio64 The audio64 payload could not be decoded.
226 multipart discarded … Multipart body was discarded by PHP — usually post_max_size / upload_max_filesize exceeded.
227 audio file extension not allowed name_up has an extension that is not an accepted audio type, or (file upload and raw body) no extension at all. See name_up. Nothing was created.
281 Error creat audio The TTS server returned a non-OK response.

Note Files uploaded via this endpoint are scanned with ClamAV before being persisted. Disable scanning is not supported.