Введение
Передайте до 10 000 символов в elevenlabs/v4/text-to-speech и выберите один из 21 готового голоса. Направляйте исполнение встроенными аудиотегами, задайте язык и формат, затем оцените готовую запись для закадрового текста или реплики персонажа.
| Характеристика | Значение |
|---|---|
| Ввод | Текст |
| Вывод | Аудио |
| Имя вызова синтеза речи | elevenlabs/v4/text-to-speech |
| Объём текста и подсказки | Обязательный text до 10 000 символов со встроенными аудиотегами |
| Голоса и значение по умолчанию | 21 готовый вариант; по умолчанию Roger |
| Варианты экспорта | 9 форматов; по умолчанию выбран |
| Наблюдавшийся запрос v4 | 13 ноября 2026: Daniel, 84 символа, en, seed 7, |
Ключевые возможности и особенности
Разместите подсказку у нужной реплики
Eleven v4 принимает в text аудиотеги в квадратных скобках, включая [whispers] и [laughs]. Начните с фрагмента, слова которого уже передают нужное настроение, затем поставьте подсказку в месте смены подачи. Наш тест содержал один тег, поэтому перед подготовкой целой сцены прослушайте дополнительные сочетания.
Прослушайте варианты из 21 голоса
В voice_id доступны 21 готовый голос, по умолчанию Roger. Сравните Daniel, Sarah и Lily на одном отрывке, прежде чем менять сценарий. ElevenLabs описывает stability как управление вариативностью, а similarity_boost — следованием голосу; clone_strength здесь готовые голоса не меняет.
Дубль Daniel с измеренным временем
13 ноября 2026 года наш запрос v4 на 84 символа использовал Daniel, language en, seed 7 и mp3_22050_32. Получено 5,17 с MP3, завершение заняло около 4,7 с. Это ориентир для одного запроса, без выводов о длинных сценариях или каждом голосе.
Задайте чтение и формат аудио
Для языка доступны auto или 91 код; у output_format девять вариантов с mp3_44100_128 по умолчанию. Через text_normalization_mode настройте раскрытие чисел и сокращений. До озвучки всего сценария проверьте фрагмент с вашими именами и датами.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
text | Да | Обязательное поле для произносимого сценария, не более 10 000 символов. Подсказки в квадратных скобках, например [whispers], ставьте рядом со словами, к которым они относятся. Не менее 1 символов · Не более 10000 символов |
voice_id | Нет | Выберите один из 21 готового голоса; по умолчанию задан Roger. Прослушайте один отрывок с Daniel, Sarah или Lily, прежде чем утвердить голос. |
language | Нет | Укажите auto для определения языка или один из 91 кода для явного выбора. Для короткой английской реплики значение en однозначно задаёт язык. |
stability | Нет | По описанию ElevenLabs, stability управляет вариативностью генераций: низкие значения дают больше эмоциональных оттенков. |
similarity_boost | Нет | ElevenLabs описывает |
output_format | Нет | Доступны девять аудиоформатов, по умолчанию |
text_normalization_mode | Нет | Режимы auto, on и off управляют раскрытием чисел и сокращений. Если дата остаётся неоднозначной, впишите её произносимую форму в сценарий и прослушайте результат. |
clone_strength | Нет | Изменение |
seed | Нет | Сохраняйте seed при сравнении одного изменения текста или настроек. Это помогает контролировать сравнение, но не гарантирует одинаковую запись. |
Стоимость
$0.096 / 1000 символов
Расход Eleven v4 измеряется числом символов в text. Рассчитывайте сумму по цене за символы и единице тарификации, указанным на этой странице.
Сценарии использования
Урок с точной инструкцией
Передайте фразу «Откройте рабочий лист и подчеркните глаголы во втором абзаце» на английском, выбрав Daniel и language en. Полученную озвучку можно разместить рядом с этим упражнением курса.
Пошаговый обзор продукта
Отправьте голосу Sarah текст «Выберите экспорт, папку назначения, затем подтвердите имя файла». Закадровая запись сможет сопровождать демонстрацию этих трёх действий на экране.
Тихая реплика игрового персонажа
Передайте Lily текст «[whispers] Стражник всё ещё за воротами». Получится отдельный дубль персонажа, который можно прослушать вместе с игровой сценой.
Локализованная инструкция приложения
Поместите утверждённый перевод инструкции по входу в text и выберите соответствующий код языка. Эндпоинт вернёт аудио этой языковой версии; перевод готовится отдельно.
Заключительная фраза рекламы
Используйте сценарий «Приходите с новой идеей на мастер-класс в эту субботу» и прослушайте готовый голос. После проверки подачи поставьте выбранную запись в конец проморолика.
Руководство по промптам и практические советы
Сформируйте входной текст
Поместите озвучку в text и начните с короткого отрывка со сложными именами или числами. Общая длина должна быть не более 10 000 символов.
Назначьте готовый голос
Укажите поддерживаемый
voice_id, затем language иoutput_formatдля нужной записи. При работе с готовыми голосами опуститеclone_strength.Запустите генерацию и оцените запись
Вызовите elevenlabs/v4/text-to-speech с описанным ниже JSON. Прослушайте аудиофайл, прежде чем применять настройки к следующему разделу сценария.
ElevenLabs v4 API для управляемой озвучки
ElevenLabs v4 API предоставляет модель синтеза речи Eleven v4 от ElevenLabs под именем elevenlabs/v4/text-to-speech. Передайте сценарий и готовый голос, чтобы получить запись с одним говорящим для урока, ролика о продукте или реплики персонажа.
В сентябрьском описании выпуска ElevenLabs предназначает v4 для создания контента и длинного аудио. Эндпоинт принимает до 10 000 символов; собственные идентификаторы голосов и диалоги с несколькими говорящими недоступны.
Пример запроса: английская реплика персонажа
Вызовите elevenlabs/v4/text-to-speech, используя следующий JSON как входные данные эндпоинта. Здесь заданы Daniel, английский язык, MP3 и seed 7; сценарий иллюстративный и отличается от текста нашего замера.
{
"text": "[whispers] Keep the lantern covered until we reach the bridge.",
"voice_id": "Daniel",
"language": "en",
"text_normalization_mode": "auto",
"output_format": "mp3_22050_32",
"seed": 7
}
Для отправки этих полей со своими учётными данными используйте пример API-запроса на странице. Публичное имя выше определяет модель; этот входной объект не описывает внешнюю структуру HTTP-запроса.
Пример результата: наблюдавшееся аудио
Отдельный запрос Daniel на 84 символа дал MP3 длительностью 5,17 с. Далее описан готовый аудиорезультат, а не схема JSON-ответа или обещание такой же длительности для иллюстративного сценария.
Audio: MP3
Selected output_format: mp3_22050_32
Recording duration: 5.17 seconds
Request completion: approximately 4.7 seconds
Параметры записи с одним голосом
Обязателен text; остальные поля задают голос, язык, исполнение или экспорт. Подготовьте озвучку с помощью этих настроек.
| Параметр | Допустимая настройка или роль | Практический выбор |
|---|---|---|
text | Обязателен; до 10 000 символов | Впишите сценарий; поставьте [whispers] или [laughs] возле нужного отрывка. |
voice_id | 21 готовый голос; по умолчанию Roger | Сравните Daniel, Sarah и Lily на одном фрагменте. |
language | auto или один из 91 кода языка | Выберите en для английского дубля или нужный код языка. |
stability | Вариативность исполнения | Меняйте на неизменном отрывке; пояснение разработчика приведено ниже. |
similarity_boost | Следование выбранному голосу | Слушайте, сохраняются ли нужные черты голоса. |
clone_strength | Не действует на готовые голоса | Для доступного здесь набора опустите поле. |
text_normalization_mode | auto, on, off | Проверьте произношение дат, количеств и сокращений. |
output_format | Девять вариантов; по умолчанию mp3_44100_128 | mp3_22050_32 соответствует формату нашего замера v4. |
seed | Начальное значение для сравнения изменений | Повторяйте его при изменении одного элемента; идентичное аудио не обещается. |
Стоимость и длина сценария
Оплата зависит от числа символов в text: для оценки используйте ставку и единицу тарификации на странице. Длительность аудио — характеристика результата, а не мера расхода этого эндпоинта. При превышении 10 000 символов разбейте сценарий на отдельные разделы.
Подготовка исполнения к публикации
Возьмите короткий фрагмент с теми же именами, числами и тоном, что нужны в готовом материале. Инструкция урока вроде «Откройте рабочий лист и подчеркните глаголы» позволит оценить голос до записи остального объяснения.
- Выберите голос, прежде чем переписывать подсказки исполнения.
- Добавьте тег в месте смены подачи и прослушайте переход.
- Задайте язык и проверьте числа с выбранным режимом нормализации.
- Сохраняйте seed при изменении одной настройки и храните настройки рядом с выбранным дублем.
В документации настроек голоса ElevenLabs указывает, что низкая stability допускает больше эмоциональных вариаций, а similarity_boost управляет следованием исходному голосу. Оценивайте подачу на слух: одна настройка не обязательно подходит всем голосам.
Исправление неудачного чтения
Если запись звучит неверно, измените соответствующие входные данные: распишите неоднозначную дату, уберите конкурирующие подсказки или попробуйте другой готовый голос. В рекомендациях по речи ElevenLabs предупреждает об ошибках чтения сложных чисел и сокращений. При сбое запроса проверьте наличие и длину text, а также соответствие голоса, языка и формата доступным на странице вариантам.
Замеры и выбор модели
Вызовы от 13 ноября 2026 года дали два конкретных образца с разными входными данными. В каждом был один аудиотег; это наблюдения, а не контролируемое сравнение.
| Вариант | Текст и голос | Язык / seed | Формат | Длина аудио | Завершение |
|---|---|---|---|---|---|
| Eleven v4 | 84 символа; Daniel | en / 7 | mp3_22050_32 | 5,17 с | Около 4,7 с |
| Eleven v4 Turbo | 75 символов; Sarah | Не указаны в описании замера | mp3_44100_128 | 3,40 с | Около 7,6 с |
Выбирайте v4 для проверяемых финальных дублей, а Eleven v4 Turbo рассмотрите для черновиков, больших объёмов и процессов, чувствительных к задержке. Приведённый замер Turbo не меняет рекомендации по назначению: сценарии, голоса и экспорт различались. Если нужны собственный голос или несколько говорящих, до планирования интеграции рассмотрите вариант с явно документированной поддержкой этих данных.
Права на запись
Публикуйте записи сценариев и голосов, на которые имеете права, без имитации реального человека. Прослушайте готовое аудио перед включением в курс, приложение или рекламный ролик.
Предоставляйте текст и выбирайте голоса, которые имеете право использовать в записи. Не выдавайте сгенерированную речь за голос реального человека.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "elevenlabs/v4/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download.",
"language": "auto",
"voice_id": "Roger",
"output_format": "mp3_44100_128",
"text_normalization_mode": "auto"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.




