Введение
Отправьте до 10 000 символов в elevenlabs/v4-turbo/text-to-speech для подсказок приложения, черновой озвучки или локализации. Выберите язык, нормализацию и формат, затем прослушайте готовое аудио перед публикацией.
| Характеристика | Значение |
|---|---|
| Ввод | Текст |
| Вывод | Аудио |
| Идентификатор речевого API | elevenlabs/v4-turbo/text-to-speech |
| Предел текста | 10 000 символов за запрос |
| Подбор голосов | 21 готовый голос; стандартный Roger |
| Параметр формата | 9 вариантов; стандартный |
| Условия записанного теста | 13 ноября 2026: 75 символов, Sarah, |
Ключевые возможности и особенности
Короткая запись Sarah с условиями замера
13 ноября 2026 года запрос Turbo на 75 символов вернул MP3 длительностью 3,40 с примерно за 7,6 с. Использовались Sarah и mp3_44100_128; это конкретный ориентир интеграции, без прогноза для других сценариев или нагрузок.
Подберите 21 голос для набора подсказок
Roger задан по умолчанию среди 21 готового голоса; другие примеры — Sarah, Daniel и Lily. Сочетайте голос с автоопределением или одним из 91 кода языка и прослушивайте реальные формулировки каждой локализованной подсказки.
Добавьте подачу рядом со словами
Теги в квадратных скобках, например [laughs] и [whispers], находятся внутри text. Наш тест содержал один тег, поэтому оценивайте полученное исполнение, не считая проверенной большую коллекцию указаний.
Выберите один из 9 форматов
По умолчанию используется mp3_44100_128; доступен также mp3_22050_32. Выберите из списка формат, принимаемый проигрывателем, и сохраняйте его при сравнении правок сценария.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
text | Да | Передайте обязательный сценарий длиной до 10 000 символов. Подсказки вроде [whispers] размещайте у нужных слов; перед большой серией генераций вычитайте текст. Не менее 1 символов · Не более 10000 символов |
voice_id | Нет | Укажите один из 21 готового голоса; без выбора используется Roger. Сравните Sarah, Daniel и Lily на одной короткой реплике вместо передачи собственного идентификатора голоса. |
language | Нет | Доступны auto и 91 поддерживаемый код языка. Для короткой локализованной подсказки задайте нужный язык и передайте уже написанный на нём текст. |
stability | Нет | Настройте ровность подачи через stability и прослушайте короткий пример. |
similarity_boost | Нет | Меняйте |
output_format | Нет | Выберите один из 9 вариантов; по умолчанию задан |
text_normalization_mode | Нет | Используйте auto, on или off для нормализации чисел и сокращений. |
clone_strength | Нет | Исключите |
seed | Нет | Фиксируйте seed, чтобы сравнивать по одному изменению сценария или настройки. Воспринимайте результат как новое исполнение, без ожидания идентичного аудио. |
Стоимость
$0.048 / 1000 символов
Оплачиваются символы text, включая пробелы, пунктуацию и встроенные теги. Голос, язык и формат вывода не меняют ставку за символ; неудачные запросы не оплачиваются. Текущая цена указана на этой странице.
Сценарии использования
Голосовые статусы приложения
Передайте Sarah фразу «Загрузка готова. Откройте предпросмотр, чтобы продолжить» для голосового уведомления. Проверьте его в реальном сценарии экранов до повторного использования голоса.
Черновики демонстрации продукта
Отправьте «Выберите рабочее пространство, добавьте файлы и откройте предпросмотр», чтобы создать черновую озвучку. Сопоставьте аудио с длительностью демонстрации перед подготовкой финального дубля.
Указания в учебном курсе
Возьмите короткий сценарий «Приостановите урок и перечислите три примера из своего проекта». Запись с одним говорящим можно проверить вместе с упражнением.
Подсказки локализованного выпуска
Передайте испанскую фразу «Ваш файл готов» с language es для голосовой подсказки приложения. Самостоятельно подготовьте перевод каждого сценария и создайте отдельную запись.
Реплики игровых персонажей
Напишите «[whispers] Ворота открыты. Следуйте за фонарями», чтобы попробовать направленную реплику NPC. В полученном исполнении одного голоса проверьте подсказку и понятность указания.
Руководство по промптам и практические советы
Составьте одну реплику Turbo
Поместите короткий вычитанный сценарий в text и назначьте ему один готовый голос.
Передайте модель и входные поля
В запросе createTask задайте model elevenlabs/v4-turbo/text-to-speech, поместив речевые поля внутрь input.
Прослушайте готовый файл
Опрашивайте recordInfo с полученным taskId, скачайте аудио после успеха и проверьте произношение в проигрывателе.
ElevenLabs v4 Turbo API для коротких речевых сценариев
ElevenLabs v4 Turbo API озвучивает текст одним готовым голосом с помощью речевой модели Eleven v4 Turbo от ElevenLabs. Применяйте его для уведомлений приложения, черновой озвучки и многоязычных записей, передавая до 10 000 символов за запрос.
В анонсе запуска ElevenLabs ориентирует Turbo на интерактивные приложения. Описанный здесь эндпоинт работает через отправленную задачу и готовый аудиофайл; приведённый ниже замер задачи не заявляет задержку потоковой передачи.
Отправка речевого запроса
Создайте задачу с model elevenlabs/v4-turbo/text-to-speech и речевыми полями в input. Отправьте POST https://api.spicyapi.ai/api/v1/jobs/createTask с Authorization: Bearer YOUR_SPICY_API_KEY и Content-Type: application/json.
{
"model": "elevenlabs/v4-turbo/text-to-speech",
"input": {
"text": "[whispers] Your preview is ready. Open it when you have a moment.",
"voice_id": "Sarah",
"language": "en",
"output_format": "mp3_44100_128"
}
}
Запрос показывает структуру полей, а не воспроизводит измеренный сценарий. При отсутствии voice_id используется Roger; собственный идентификатор голоса здесь не принимается.
Получение ответа
Опрашивайте GET /api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID с идентификатором, полученным при отправке. Сохраните его для проверки той же задачи.
Сокращённый ответ на создание может выглядеть так:
{
"code": 200,
"data": {
"taskId": "YOUR_TASK_ID",
"state": "queued"
}
}
Сокращённый ответ успешно завершённой задачи предоставляет аудиофайл:
{
"code": 200,
"data": {
"taskId": "YOUR_TASK_ID",
"state": "succeeded",
"output": {
"assets": [
{"url": "https://example.com/turbo-result.mp3", "mime": "audio/mpeg"}
]
}
}
}
В этих фрагментах идентификаторы и URL служат заполнителями. После успеха скачайте файл из data.output.assets и прослушайте в целевом проигрывателе.
Параметры и возможности эндпоинта
Входные настройки охватывают текст, готовый голос, язык, подачу, нормализацию, формат вывода и seed. Используйте предусмотренные варианты каждого элемента, не перенося поля из другого речевого API.
| Параметр | Поддерживаемые данные или назначение | Практический выбор |
|---|---|---|
text | Обязателен; до 10 000 символов | Вычитайте слова и встроенные подсказки |
voice_id | 21 готовый голос; по умолчанию Roger | Попробуйте Sarah, Daniel или Lily на короткой реплике |
language | auto или один из 91 кода языка | Укажите язык подготовленного сценария |
stability | Управление постоянством подачи | Сравнивайте изменение при неизменном голосе |
similarity_boost | Управление сходством с выбранным голосом | После настройки прослушайте ту же фразу |
clone_strength | На готовые голоса не действует | Опустите для доступного здесь набора |
text_normalization_mode | auto, on или off | Проверьте чтение чисел и сокращений |
output_format | 9 вариантов; по умолчанию mp3_44100_128 | mp3_22050_32 — ещё один вариант MP3 |
seed | Помогает контролировать сравнение | Не ожидайте идентичных записей |
Тарификация по символам
Оплата этого речевого эндпоинта определяется символами текста, а не секундами сгенерированного аудио. Для оценки серии используйте сценарии и актуальную цену на странице; по длительности полученного MP3 стоимость не выводится.
Улучшение подачи перед увеличением объёма
Короткие пробные сценарии позволяют оценить произношение и исполнение до записи большой коллекции. Для уведомления попробуйте «Загрузка готова. Откройте предпросмотр, чтобы продолжить» и прослушайте переход между предложениями.
- Начните с одного голоса и сценария без тегов для исходного образца.
- Добавьте
[whispers]или[laughs]там, где меняется подача, и прослушайте снова. - Сравните нормализацию на реальных числах или сокращениях проекта.
- Сохраняйте голос, формат и seed, меняя один элемент сценария или настройки подачи.
Постоянный seed упрощает сравнение, не обещая совпадения результата. Подготовьте перевод до выбора кода языка: сам выбор языка текст не переводит.
Что показали наши замеры
Вызов Turbo от 13 ноября 2026 года с 75 символами и Sarah вернул MP3 на 3,40 с примерно за 7,6 с. В тесте был один встроенный тег; более широкий словарь тегов не проверялся.
| Вызов | Символов текста | Голос | Формат вывода | Длительность аудио | Время завершения |
|---|---|---|---|---|---|
| v4 Turbo | 75 | Sarah | mp3_44100_128 | 3,40 с | Около 7,6 с |
| v4 | 84 | Daniel | mp3_22050_32 | 5,17 с | Около 4,7 с |
Это наблюдения при интеграции, а не контролируемое сравнение: различаются сценарии, голоса и форматы. В вызове v4 также были заданы английский язык и seed 7; ни один результат не прогнозирует работу со следующим сценарием.
Ограничения, ошибки и выбор модели
При разборе отклонённого запроса проверьте предел 10 000 символов и выбор готового голоса из списка. Диалоги с несколькими говорящими и собственные идентификаторы здесь пока не доступны, а clone_strength не меняет готовые голоса.
При сбое изучите ошибку и отправленные поля до повторения изменённого запроса. Если аудио готово, но число звучит неверно, проверьте короткий фрагмент с другой нормализацией и явно записанными словами.
Turbo подходит для черновиков, объёмных библиотек подсказок и процессов с приоритетом задержки. Для финальной озвучки сравните ElevenLabs v4 с тем же сценарием и настройками; при необходимости собственных голосов или диалогов рассмотрите иной речевой эндпоинт, проверив его документированные возможности. Перед публикацией исполнения 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-turbo/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.




