ElevenLabs V4 TTS - Vidgo API

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "elevenlabs/tts/eleven-v4",
  "input": {
    "text": "[whispers] Wait... that ticking is coming from inside the wall. [curious] This little brass key fits the crack. [excited] The whole ceiling is full of stars! [laughs]",
    "voice": "Charlotte",
    "stability": 0.35,
    "language_code": "en"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1762160000-abc123",
    "status": "not_started",
    "created_time": "2026-11-03T10:30:00"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Request timeout

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

POST

api

generate

submit

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "elevenlabs/tts/eleven-v4",
  "input": {
    "text": "[whispers] Wait... that ticking is coming from inside the wall. [curious] This little brass key fits the crack. [excited] The whole ceiling is full of stars! [laughs]",
    "voice": "Charlotte",
    "stability": 0.35,
    "language_code": "en"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1762160000-abc123",
    "status": "not_started",
    "created_time": "2026-11-03T10:30:00"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Request timeout

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

After submission, a task_id will be returned. If you provided a callback_url, when the task status becomes finished or failed, a POST request will be sent to the callback_url.
Regardless of whether callback_url is provided, you can retrieve the result through the unified Query Task Status endpoint.

ElevenLabs V4 TTS converts text into expressive speech with Eleven v4, the most emotive ElevenLabs model. Inline audio tags such as [whispers] or [laughs] direct the delivery, and voice, stability, language and output-format controls cover audiobooks, video voice-overs, podcasts, game characters and e-learning narration in 90+ languages. Eleven v4 and Eleven v4 Turbo are ElevenLabs text-to-speech models released together in September 2026. They take the same request fields on Vidgo: ElevenLabs V4 TTS is the most expressive option, and ElevenLabs V4 Turbo TTS is the faster, lower-cost variant.

Models

elevenlabs/tts/eleven-v4 — Eleven v4 text-to-speech, the most expressive ElevenLabs voice model.

Features

Text-to-speech for up to 5,000 characters per request.
Inline audio tags in text for emotion, pauses and non-verbal sounds.
Any ElevenLabs voice by name or voice ID, with stability and similarity_boost tuning.
90+ languages, with an optional language_code hint.
19 output formats across MP3, PCM, μ-law, A-law and Opus.
Optional timestamps for subtitles and lip-sync.

Required parameters

text (string): The text to speak, 1–5,000 characters, not blank. Audio tags in square brackets, such as [whispers], are allowed.

Optional parameters

voice (string): ElevenLabs voice name or voice ID. Default Rachel. See Voice Presets.
stability (number): 0–1. Default 0.5. Lower values are more expressive, higher values more consistent.
similarity_boost (number): 0–1. Default 0.75. How closely the output follows the selected voice.
output_format (string): One of 19 MP3, PCM, μ-law, A-law and Opus formats. Default mp3_44100_128. See Output Formats.
apply_text_normalization (string): auto, on or off. Default auto. Controls whether numbers, dates and abbreviations are spelled out.
timestamps (boolean): Also return timing data for the speech. Default false.
language_code (string): ISO 639-1 language hint, such as en, zh or ja. Omit it to let the model detect the language.

Output

The finished task returns the speech as an audio file in the files array of Query Task Status and the callback payload. With timestamps: true, the timing data is returned as an additional item in the same array.

Output Formats

Family	Values
MP3	`mp3_22050_32`, `mp3_44100_32`, `mp3_44100_64`, `mp3_44100_96`, `mp3_44100_128` (default), `mp3_44100_192`
PCM	`pcm_8000`, `pcm_16000`, `pcm_22050`, `pcm_24000`, `pcm_44100`, `pcm_48000`
Telephony	`ulaw_8000`, `alaw_8000`
Opus	`opus_48000_32`, `opus_48000_64`, `opus_48000_96`, `opus_48000_128`, `opus_48000_192`

The value reads as codec, sample rate in Hz and, for compressed formats, bitrate in kbps. pcm_* suits further audio processing; ulaw_8000 and alaw_8000 suit phone systems.

Voice Presets

voice accepts any ElevenLabs voice name or voice ID available to the model. Commonly used names include Aria, Roger, Sarah, Laura, Charlie, George, Callum, River, Liam, Charlotte, Alice, Matilda, Will, Jessica, Eric, Chris, Brian, Daniel, Lily, Bill, Rachel. The default is Rachel.

Examples

Story narration with audio tags: [whispers], [curious], [excited] and [laughs] inside text, with voice: Charlotte and a lower stability for more expressive delivery.
Podcast intro as WAV-ready PCM with timestamps: output_format: pcm_44100, timestamps: true for subtitle alignment, and a callback_url.

Notes

Credits are reserved at submission and depend on the number of characters in text as sent, including spaces, line breaks and audio tags. A failed task is refunded in full. See the pricing page for current rates.
text is limited to 5,000 characters per request. Split longer scripts into several tasks.
This endpoint produces a single voice per request. Multi-speaker dialogue, voice cloning, streaming, seed and speed are not available through it; unsupported fields return 400.
For lower cost and faster turnaround with the same fields, use ElevenLabs V4 Turbo TTS.

Authorizations

Authorization

string

header

required

All API endpoints require Bearer Token authentication

Get your API Key:

Go to Dashboard → API Key (API Key Management Page) to get your API Key

Add it to the request header:

Authorization: Bearer VIDGO_API_KEY

Body

application/json

model

string

required

Model ID. Use elevenlabs/tts/eleven-v4.

Example:

"elevenlabs/tts/eleven-v4"

input

object

required

Generation parameters.

Show child attributes

callback_url

string<uri> | null

Optional public HTTP(S) endpoint that receives a POST when the task becomes finished or failed. HTTPS is recommended. Omit it, or send null or an empty string, to disable callbacks.

Example:

"https://your-domain.com/callback"

Response

Task submitted

code

enum<integer>

required

HTTP status code.

Available options:

200

data

object

required

Show child attributes

​Models

​Features

​Required parameters

​Optional parameters

​Output

​Output Formats

​Voice Presets

​Examples

​Notes

Authorizations

Body

Response

Models

Features

Required parameters

Optional parameters

Output

Output Formats

Voice Presets

Examples

Notes