ElevenLabs: Eleven Turbo v2
Eleven Turbo v2 — англоязычная версия синтеза речи ElevenLabs для голосовых приложений с быстрым откликом. Она озвучивает переданный текст выбранным голосом и подходит для ответов ассистента, уведомлений и коротких объяснений, подготовленных для прослушивания.
О модели
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
Eleven Turbo v2 — англоязычная модель синтеза речи ElevenLabs для приложений, которым нужны голосовые ответы с быстрым откликом. Она получает подготовленный текст реплики и возвращает аудио выбранным голосом. Производитель выделяет Turbo v2 отдельно от многоязычной Turbo v2.5 и линейки Flash. Её практическая роль — голосовой ответ на английском: подтверждение, короткое объяснение или следующая инструкция в диалоговом интерфейсе.
Английский язык определяет языковые возможности этой версии. Текст на другом языке не придаёт Turbo v2 многоязычность v2.5. Выбирайте голос с нужными для английского сценария акцентом и манерой подачи. Тёплый разговорный голос, сдержанный рассказчик и энергичный персонаж произнесут одну фразу по-разному, поэтому выбор голоса входит в задание и не определяется по умолчанию названием модели.
Подготовьте чистый текст для озвучивания. Модель синтезирует переданные слова; она не решает, успешно ли выполнено действие, и не формирует рассуждения приложения. В ответе ассистента укажите один ясный результат и естественный следующий шаг. Например, реплика может подтвердить получение документа и запросить недостающий регистрационный номер. Внутренние инструкции и метаданные держите отдельно от произносимых слов: обычный описательный текст тоже может быть озвучен.
Имена, сокращения и числа требуют осознанной подготовки. Запишите идентификатор отдельными цифрами, если его нужно повторить именно так, и раскройте сокращение, если слушатель должен услышать полное значение. Для даты используйте однозначную словесную форму. Псевдонимы произношения или альтернативное написание помогут задать нужное звучание сложного имени. Если приложение также показывает сообщение текстом, храните исходное написание отдельно от формы для озвучивания.
Настройки голоса производителя влияют на постоянство звучания, сходство и темп. В общем руководстве TTS скорость 1.0 означает исходный темп, а диапазон составляет от 0.7 до 1.2; крайние значения могут влиять на результат. Stability меняет вариативность и эмоциональный диапазон, similarity — сходство с выбранным голосом. Эти настройки не делают синтез детерминированным и не задают точную длительность реплики. Пунктуация и законченная структура предложений остаются важными для подачи.
Точный лимит API Turbo v2 у производителя — 30 000 символов на запрос. Это предел входного текста, а не фиксированная длительность аудио; длинный материал готовьте целыми предложениями или разделами. Семейство форматов TTS ElevenLabs включает MP3 для обычного прослушивания, несжатый 16-битный PCM, телефонные кодировки μ-law и A-law, а также Opus. Потоковый сценарий возвращает аудио постепенно, а полный текстовый запрос можно собрать в запись. Выбирайте формат под место воспроизведения и храните фактический сценарий вместе с выбранным аудио. Длинное объяснение делите по смысловым границам, чтобы слушателю не пришлось воспринимать один растянутый список.
Для практического ответа англоязычной поддержки подготовьте точный результат, ясно произносимое имя или идентификатор и следующее действие. Прослушайте нужный фрагмент записи, проверив разборчивость, акцент и естественный ритм. Производитель указывает на недетерминированность результата, поэтому одинаковые настройки могут давать немного разную подачу. Повторно используемый материал — выбранная речевая запись вместе с подготовленным текстом и настройками голоса для ассистента, уведомления, учебной подсказки или короткого записанного объяснения.
Ailoot Ultra · Озвучка POST /v1/audio/speech elevenlabs/eleven-turbo-v2
elevenlabs/eleven-turbo-v2Начало
Eleven Turbo v2 — англоязычная версия синтеза речи ElevenLabs для голосовых приложений с быстрым откликом. Она озвучивает переданный текст выбранным голосом и подходит для ответов ассистента, уведомлений и коротких объяснений, подготовленных для прослушивания.
- Допустимые входные данные
- Текст
- Результаты
- Аудио
Доступно в Ailoot · входные данные и методы
Ailoot Ultra · Озвучка POST /v1/audio/speech
- Входные данные
text- Результат
audio- Выходной формат
- mp3
| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения elevenlabs/eleven-turbo-v2 | По умолчанию— |
Полеinput | Типstring | ТребованиеОбязательно | Значения и ограничения Минимальная длина: 1 Максимальная длина: 30 000 Единица: символы Unicode | По умолчанию— |
Полеvoice | Типstring | ТребованиеОбязательно | Значения и ограничения george, sarah, adam, alice, bella, bill, brian, callum, charlie, chris, daniel, eric, harry, jessica, laura, liam, lily, matilda, river, roger, will | По умолчанию— |
Полеresponse_format | Типstring | ТребованиеОбязательно | Значения и ограничения mp3 | По умолчанию— |
Сочетания входных материалов
text_to_speech · Обязательно: input
Параметры и жизненный цикл метода
| Параметр | Контракт |
|---|---|
Параметрcontent_type | Контрактapplication/json |
Параметрrequired | Контрактmodel, input, voice, response_format |
Параметрvoice_ids | Контрактgeorge, sarah, adam, alice, bella, bill, brian, callum, charlie, chris, daniel, eric, harry, jessica, laura, liam, lily, matilda, river, roger, will |
Параметрresponse_format | Контрактmp3 |
Параметрmax_input_characters | Контракт30000 |
Параметрother_options | Контрактfalse |
Параметрinput | Контрактточный текст UTF-8; количество символов Unicode без нормализации |
Параметрmaterial_types | Контрактtext |
Жизненный цикл: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Фактически возвращённый task_id или запись в медиатеке
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Выберите точный голос из профиля этой модели.
Входные символы и секунды аудио — разные единицы учёта.
Тарифы
Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.
- Быстрый режим
- Не указано При выборе быстрого режима
- Режим flex
- Не указано При выборе режима flex
- Максимальная интенсивность рассуждений
- Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)
Ставки Ailoot
Цены по конфигурациям
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Шкала ставок | Расчётная единица | Плата |
|---|---|---|---|
| КонфигурацияБазовые тарифы на токены | Шкала ставокБазовая ставка | Расчётная единица— | Плата Вход · Входные токены — / 1K токенов Выход · Выходные токены — / 1K токенов Вход · Чтение кэша — / 1K токенов Вход · Запись в кэш — / 1K токенов Вход · Запись в кэш, 1 час — / 1K токенов |
| Конфигурациявходной символ | Шкала ставок— | Расчётная единицаза входной символ | Плата Вход · входной символ $0.00008 за входной символ |
Сведения о справочном тарифе
Справочные шкалы модели не меняют выбор метода, расчёт стоимости или списания. Действующая плата определяется ставками выбранного метода Ailoot.
ElevenLabs: Eleven Turbo v2
Цены по конфигурациям
| Конфигурация | Условия расчёта | Плата |
|---|---|---|
| КонфигурацияElevenLabs: Eleven Turbo v2 · Стандартная конфигурация | Условия расчётаКонфигурация по умолчанию | Плата Вход · Входные символы 0,00004 $ за входной символ |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
Примеры запросов
Ailoot Ultra · Озвучка
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VOICE_ID:?Choose an accepted voice ID from this exact model profile}"
export AILOOT_VOICE_ID
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "elevenlabs/eleven-turbo-v2", "input": "Good afternoon! This is a short voice take."}')
voice=os.environ["AILOOT_VOICE_ID"]
allowed=json.loads('["george", "sarah", "adam", "alice", "bella", "bill", "brian", "callum", "charlie", "chris", "daniel", "eric", "harry", "jessica", "laura", "liam", "lily", "matilda", "river", "roger", "will"]')
if voice not in allowed: raise SystemExit("Choose an accepted voice ID from this exact model profile")
p["voice"]=voice
p["response_format"]="mp3"
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/audio/speech \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o speech.mp3
Получить и сохранить результаты
Ailoot Ultra · Озвучка
mp3
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Чтение другого содержимого
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-assets.json
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_MEDIA_TASK_ID:?Set the actual ID returned by the response or media-library metadata}"
export AILOOT_MEDIA_TASK_ID
resource_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_MEDIA_TASK_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/media/tasks/$resource_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-task.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path("media-task.json").read_text())))
PY_RESULT
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_ASSET_ID:?Set the actual ID returned by the response or media-library metadata}"
export AILOOT_ASSET_ID
resource_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_ASSET_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/media/assets/$resource_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-asset.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path("media-asset.json").read_text())))
PY_RESULT
Сохраняйте все готовые результаты
Сохраняйте каждый полностью полученный ответ, файл и элемент содержимого.
Сохраняйте полный бинарный результат и заголовки. Если возвращаются JSON или несколько результатов, сохраняйте каждый элемент данных и загружайте ресурс по каждому фактически возвращённому подписанному URL.
Если нужно проверить исходный ответ
Сохраняйте исходный operation_id/X-Client-Request-ID для сверки без повторной отправки; отдельного маршрута опроса аудио нет.
Поля ответа
| Поле | Тип |
|---|---|
Полеbinary audio | Типbytes |
Полеresponse headers | Типheaders |
Ошибки и дальнейшие шаги
| Ответ | Условие | Следующий шаг |
|---|---|---|
Ответ400 · invalid_request_error | УсловиеНеверные обязательные поля, представление материалов или значение параметра | Следующий шагИсправьте указанные поля перед новым запросом на создание. |
Ответserver_error | УсловиеВозвращённый ответ указывает, что операция или результат требуют проверки | Следующий шагСохраните исходный возвращённый ID операции или задачи, заголовки запроса и ответ; продолжайте поддерживаемые операции чтения исходной операции. Не отправляйте запрос создания повторно. |
Псевдонимы
Псевдонимы моделей
Ailoot Ultra elevenlabs/eleven-turbo-v2
Псевдонимы путей метода
Используйте пути методов, указанные выше.
Связанные ID для вызова
FAQ · ElevenLabs: Eleven Turbo v2
- Какие входные данные и результаты доступны?
POST /v1/audio/speech·elevenlabs/eleven-turbo-v2:text→audio- Какие поля использует запрос?
POST /v1/audio/speech·elevenlabs/eleven-turbo-v2:model,input,voice,response_format- Какие ограничения действуют?
POST /v1/audio/speech·elevenlabs/eleven-turbo-v2:input.maximum_length:30000