# ElevenLabs Eleven v4 Turbo - Core.Today AI API

> ElevenLabs Eleven v4 Turbo text-to-speech via Fal.AI. The Turbo tier of Eleven v4 at half the rate, with the same audio tags, IPA pronunciation, voice controls and optional character-level timestamps.

- **Provider**: ElevenLabs
- **Model ID**: elevenlabs/tts/eleven-v4-turbo
- **Category**: Audio & TTS
- **Credits**: 93 per 1000 characters (0.093 credits/char, billed per character)
- **Speed**: Fast
- **Quality**: High

## Features
- Half the per-character rate of Eleven v4
- Same audio tags ([whispering], [excited]) and IPA pronunciation support
- Stability and similarity controls
- Up to 5,000 characters per request with optional character-level timestamps

## Use Cases
- High-volume voiceover where cost per character matters
- Product UI prompts, notifications and IVR messages
- Drafting narration before a final Eleven v4 render
- Localized voice content across many short scripts

## API Endpoint

Base URL: https://api.core.today/v1
Create Prediction: POST /predictions
Get Status: GET /predictions/{job_id}

## Authentication
Header: X-API-Key: YOUR_API_KEY

## Input Parameters

### Required
- **text**: string - The text to convert to speech (max 5,000 characters, billed per character). Supports audio tags such as [whispering] or [excited] and IPA pronunciation enclosed in forward slashes.

### Optional
- **voice**: string (default: Rachel) - The voice to use — an ElevenLabs premade voice name (e.g. Rachel, Aria, Roger, Sarah, George) or a voice ID.
- **stability**: number (default: 0.5) - Voice stability (0-1). Lower values allow more expressive delivery; higher values make delivery more consistent.
- **similarity_boost**: number (default: 0.75) - How closely the output follows the reference voice (0-1). Higher values increase similarity but may reduce naturalness.
- **language_code**: string - Language code (ISO 639-1, e.g. en, ko, ja) for speech generation and text normalization. Auto-detected when omitted.
- **apply_text_normalization**: string (default: auto) - Whether to normalize text such as numbers and dates before generation.
  Options: auto, on, off
- **output_format**: string (default: mp3_44100_128) - Output audio format, formatted as codec_sample_rate_bitrate (MP3 variants).
  Options: mp3_22050_32, mp3_44100_32, mp3_44100_64, mp3_44100_96, mp3_44100_128, mp3_44100_192
- **timestamps**: boolean (default: false) - Whether to return character-level timing information with the generated audio.
- **seed**: integer - Seed for best-effort reproducibility. Identical output is not guaranteed.

## Examples

### Excited greeting
A short line using an audio tag to set an excited delivery.
```json
{
  "model": "elevenlabs/tts/eleven-v4-turbo",
  "input": {
    "text": "[excited] Hello! Welcome to Eleven v4.",
    "voice": "Aria"
  }
}
```

### App notification
A concise, consistent notification line with higher stability.
```json
{
  "model": "elevenlabs/tts/eleven-v4-turbo",
  "input": {
    "text": "Your order has shipped and will arrive tomorrow.",
    "voice": "Roger",
    "stability": 0.8
  }
}
```

## Response Format
```json
{
  "job_id": "abc123",
  "status": "pending | processing | completed | failed",
  "result": "URL or data (when completed)"
}
```

## Usage Flow
1. POST /predictions with model and input -> receive job_id
2. GET /predictions/{job_id} -> poll until status is completed or failed
3. Result contains output URL(s)

## Tips
- Billing counts every character of text, including audio tags.
- Prototype scripts on Turbo, then switch to Eleven v4 if you need the flagship tier for the final take.
- Raise stability for short system prompts that must sound identical every time.
- Choose an MP3 bitrate that fits the channel — 32-64 kbps is enough for telephony-style playback.

## Documentation
https://fal.ai/models/elevenlabs/tts/eleven-v4-turbo