ElevenLabs

elevenlabs/text-to-dialogue

Семейство генерации речи и аудио для разработчиков: синтез речи из текста, диалоговая речь, звуковые эффекты и генерация музыки

elevenlabs/music-v2 elevenlabs/sound-effects-v2 elevenlabs/text-to-dialogue

Попробовать elevenlabs/text-to-dialogue

Ввод

Работы

Все работы

Вывод

audio

Заполните параметры и сгенерируйте — результаты появятся здесь.

Цены

elevenlabs/text-to-dialogue per 1,000 characters

Цена за единицу	$0.125

Описание и позиционирование

elevenlabs/text-to-dialogue — это интерфейс, который напрямую синтезирует речь из текста многорепликового диалога: вызывающая сторона описывает каждую реплику и её голос в виде массива { text, voice }, а модель построчно выдаёт соответствующую речь; суммарный объём всех реплик в одном запросе не превышает 5000 символов. Он подходит разработчикам, которым нужно получить аудио диалога двух или более персонажей за один запрос, например для озвучивания коротких пьес, подкаст-бесед, демонстрационных материалов для голосовых ассистентов и речевого воплощения интерактивного контента.

Ключевые возможности

Голос задаётся построчно, многорепликовый диалог синтезируется за один запрос — каждая реплика в массиве dialogue отдельно привязывается к voice_id, не нужно разбивать на несколько одиночных синтезов и затем склеивать.
Голос можно менять для каждой реплики, доступно более 60 кандидатных голосов — перечисление voice в схеме предоставляет десятки вариантов, разные персонажи в одном диалоге могут использовать разные голоса.
Параметр стабильности регулируется целиком — stability поддерживает три значения: 0, 0.5, 1, что позволяет выбирать между эмоциональной выразительностью и постоянством тембра.
Язык определяется автоматически или задаётся явно — если language_code оставить пустым, язык определяется автоматически; также можно явно указать код языка ISO, поддерживается более 70 языков.

Описание возможностей

Синтез многорепликового диалога: реплики и голоса описываются в массиве диалога, один вызов выдаёт аудио диалога с несколькими персонажами, избавляя от посегментного синтеза и ручной склейки.

Построчная привязка голоса: голос каждой реплики выбирается независимо, что удобно для назначения разным персонажам разных голосов с сохранением их индивидуальных голосовых характеристик.

Управление стабильностью и языком: stability управляет амплитудой эмоциональных изменений в выразительности, language_code определяет язык озвучивания или передаётся на автоматическое определение, что удобно для пакетной обработки материалов с фиксированным языком.

Обработка длинных текстов диалога: суммарный лимит всех реплик в одном запросе — 5000 символов, что подходит для единовременной отправки цельного фрагмента диалога без заботы о внутреннем разбиении.

Сценарии применения

Создатели коротких пьес и сюжетного контента: сценарии многорепликового диалога — отправьте реплики с распределением по персонажам вместе с их голосами и получите полное аудио диалога для сюжетного воплощения коротких пьес, радиоспектаклей или интерактивных драм.
Контент для подкастов и интервью: сценарии бесед — преобразуйте текст беседы двух собеседников в звуковую дорожку диалога с разными голосами и используйте её напрямую как фрагмент подкаста или пилотный образец передачи.
Продуктам и контент-командам: материалы многоязычных диалогов — укажите код языка и синтезируйте диалоговое аудио на нужном языке для озвучивания и демонстрации зарубежных версий контента.
Разработчикам: материалы прототипов голосовых диалогов — быстро создавайте образцы аудио с несколькими персонажами для прототипов голосовых ассистентов, роботов поддержки и т. п., для проверки сценариев и внутренних демонстраций.

Ограничения и рекомендации по выбору

На выходе получается аудио, изображение или видео не создаётся; при необходимости готового видеоряда визуальное производство выполняется отдельно. Суммарный объём всех реплик в одном запросе не превышает 5000 символов, слишком длинные сценарии нужно самостоятельно разбивать на несколько вызовов и склеивать. Голос можно выбрать только из списка voice, предоставляемого интерфейсом, напрямую клонировать новый голос нельзя. Если сценарий включает только один фрагмент закадрового текста или чтение одним человеком, достаточно воспользоваться одиночной линией преобразования текста в речь — создавать массив диалога не требуется.

Частые вопросы

Все частые вопросы →

Что такое Turbo 2.5?

Модель синтеза речи с низкой задержкой от ElevenLabs, подходит для голосовых помощников, озвучивания уведомлений и массового дубляжа.
Как вызвать?

Передайте model (elevenlabs/text-to-speech-turbo-2-5) и input в POST /v1/tasks, затем запросите результат по taskId или настройте callback.
Как осуществляется оплата?

Оплата взимается по количеству символов в input.text, за каждые 1 000 символов; актуальная цена за единицу указана в разделе цен на этой странице.
Платны ли previous_text и next_text?

Нет, они бесплатны. Они лишь предоставляют контекст для синтеза по сегментам, чтобы интонация звучала естественно.

Создать задачу генерации

POST https://api.hiapi.ai/v1/tasks

Заголовки

AuthorizationstringОбязательно

API-ключ аккаунта. Обязателен в каждом запросе. Пример: Bearer YOUR_HIAPI_API_KEY. Получить API-ключ

Content-TypestringНеобязательно

Тело запроса всегда разбирается как JSON; при отправке принимается только application/json (charset опционален) — любое иное значение возвращает 415. Пример: application/json.

Idempotency-KeystringНеобязательно

Ключ идемпотентности, до 255 байт. Повторные запросы с тем же ключом того же аккаунта создают задачу лишь один раз; реплеи возвращают исходный taskId.

Ключ идемпотентности

При сетевых таймаутах или автоповторах клиента один и тот же ключ создаёт задачу только один раз, без двойного списания (область = аккаунт API-ключа). Рекомендуется бизнес-уникальный идентификатор (напр. "order-42"); реплеи возвращают исходный taskId, ключ истекает через 24 часа после первого запроса. Полная матрица сценариев — во введении единого асинхронного API.

Тело запроса

modelstringОбязательно

Текущее фиксированное значение: elevenlabs/text-to-dialogue

routestringНеобязательно

Текущее фиксированное значение: default

inputobjectОбязательно

Объект бизнес-параметров для elevenlabs/text-to-dialogue и маршрута default — см. таблицу параметров ниже.

dialoguearrayОбязательноminItems 1

Массив диалоговых элементов; каждый элемент массива содержит поля text и voice, которые задают реплику этой строки и используемый для неё тембр голоса. Общее количество символов в полях text всех диалоговых элементов не должно превышать 5000.

Array [ object ]

Элементы массива

textstringОбязательноminLength 1

Текстовое содержимое данной реплики диалога. Общее количество символов во всех полях text массива диалога не должно превышать 5000.

voicestringОбязательноПо умолчанию: "EkK5I93UQWFDigLMpZcX"

Тембр голоса, используемый для данной реплики; можно указать имя предустановленного тембра или voice_id. По умолчанию EkK5I93UQWFDigLMpZcX.

Варианты:EkK5I93UQWFDigLMpZcXZ3R5wn05IrDiVCyEkUrKNNl6r8mD7vthiJatiJt1YOq2y2Up4RgXP2HyXjE5B8gJV1IhpuegLxdpXFOE2zRM7PkgwBPiau2jvVXc1SM7GgM6IMuvQlz2BwM35l5f8iK3YPeGga21rQIX

Показать все (59)

scOwDtmlUjD3prqpp97INOpBlnGInO9m6vDvFkFCBZgkqPqms7Kj9ulSkVznwo6udizrrtpIxWGp2qJkgU0LNdkMOQCOrPrwtbeeDGzg6RaUqxGRTHSBjfgFx70vRnQBMBu4FAYhjJbOSm1seazb4gs7RSlUVw7cP1bg08DkjqiVEzOn76yGqDuRKMlYmrm8trt5QyBnqXpMhyvQqiRxWQs4qSSBTX3LPaxmHKxFdv7VOQHJN2lVS1w4EtoT3dr4eOWOFGY2WhTYpPnrIDTdsKH5kPzsL2i3teMYv0FxEYQ6UgBBYS2sOqTuMpoF3BR0hpp4J3VqNfWAUOO0d1UsnPczCjzI2devNBz1zQrbuYXf8XasLslADfZ2MB4ugs0tAILXbY5DNrJrsM6FDTKMou8ccj1ZaWGBiotdvBKc2FfBKJfcZNyEt1n6DYkrAHD8iwork3YSUBbs56AoDkrOh6qfVPDXZ7PteR40ATw9ArzDf9h3v7t7g6xIsTj2HwM6VR4iXFCwlcMyyd2HUfFzxdCaC4Ta6aDn1KB0hjpdcocrUkmqSq93GQT4X1lKDXsQcixOflHkNRp1BlvT73UL6gyz9yzdeviXkFddZ4Oz8MokpPdl9cQBQq4p6mRkZy2ZzYcjlYFOd3taleS0gkk3nzeAacJi50IvxcyDnMXaruirxsoakN0GWmGNIo04TC0Zp7WVFzhA8zpTlRqVljo9gAlSqKOvF6D8sOsXPPzYpIqttlTYA83688JI8JVbfL6oEdmuxKn5DK2CiCrDUkL56s3C8sCRl7wbwJqPPQ618aTW29mptyocEiNlNiXeDU1pqqOPrYMO4YYIPFl9wE5c4L2eu2Gb6F5Zhi321D3Oq7v1oNT4YXpFCvM1S3JbWEJhoskWLG95yZDEHg6fCZdQjLqjCeNX9CMwmxDxUF5Q2InmaD6riP1btT197c6dACmymtrellq69YZsNwzUSyXhdHd5gvgSOzSfduK4CvEgeVItLK1UvXctxuaRV2Oqesy0r39YPLQjOczyOib8Tsns2HvNFKfGiNjllgqo1U02n4nD6AdIZ9CjF053AeRdCCKzvd23BpJoofzxLruHrtVF6PSyGItzMNHS1wGbFxmAM3Fgw63G1zZJhqfrgApggtO1785R4FsnMJ0RnG71ty4LH3dvNfSd

stabilitynumberНеобязательноПо умолчанию: 0.5

Стабильность тембра голоса: чем меньше значение, тем богаче эмоции и больше вариаций, чем больше значение, тем стабильнее и единообразнее вывод. По умолчанию 0.5.

Варианты:00.51

language_codestringНеобязательноПо умолчанию: ""

Код языка (в формате ISO). Если оставить пустым, язык определяется автоматически; по умолчанию поле пустое.

Варианты:afarhyasazbebn

Показать все (67)

bsbgcacebnyhrcsdanlenetfilfifrglkadeelguhahehihuisidgaitjajvknkkkykolvlnltlbmkmsmlzhmrnenopsfaplptparorusrsdskslsoesswsvtatethtrukurvicy

callbackobjectНеобязательно

Настройка уведомления о терминальном состоянии. Если не задана — обратных вызовов нет, опрашивайте задачу сами.

Обратные вызовы (Webhook)

Укажите callback.url при создании, и HiAPI отправит POST вашему сервису в терминальном состоянии — опрос не нужен. Тело callback повторяет структуру деталей задачи; проверка подписи, повторы и идемпотентность описаны во введении единого асинхронного API.

urlstringОбязательно

Обязательна при наличии callback. В терминальном состоянии на этот URL отправляется POST; это должна быть корректная http(s)-ссылка.

whenstringНеобязательноПо умолчанию: "final"

Сейчас поддерживается только final — уведомление и при success, и при fail.

Варианты:final

storagestringНеобязательноПо умолчанию: "temp"

Уровень хранения артефактов: temp (по умолчанию, ~7 дней) или persistent (долгосрочно, оплата по объёму). При нехватке баланса или превышении лимита — тихое понижение до temp; фактический уровень виден в ответе деталей задачи.

Варианты:temppersistent

Примеры запроса

# Отправляет асинхронную задачу; сразу возвращает taskId (не ждёт генерации)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "elevenlabs/text-to-dialogue",
  "input": {
    "dialogue": "…",
    "stability": 0.5,
    "language_code": ""
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "elevenlabs/text-to-dialogue",
    input: {
      "dialogue": "…",
      "stability": 0.5,
      "language_code": ""
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "elevenlabs/text-to-dialogue",
        "input": {
          "dialogue": "…",
          "stability": 0.5,
          "language_code": ""
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Получить детали задачи

GET https://api.hiapi.ai/v1/tasks/:id

Поля ответа

taskIdstringОбязательно

Идентификатор задачи, всегда с префиксом tk-hiapi-.

modelstringОбязательно

Полное разрешённое имя модели. Задачи, отправленные с параметром route, возвращают base@route (напр. gpt-image-2/text-to-image@ext); иначе совпадает с переданным именем.

routestringНеобязательно

Присутствует только при явном параметре route; повторяет переданное значение.

statusstringОбязательно

Статус задачи.

Значения статуса

queued В очереди, ещё не начата. handling Обрабатывается. archiving Обработка завершена, готовятся артефакты. success Терминальное: завершено, артефакты доступны (возвращается output). fail Терминальное: ошибка (возвращается error). После отправки следите за status: success и fail — терминальные, остальные нет. Опрашивайте каждые 1–3 с до терминального состояния. При успехе скачайте артефакты из output[].url и перенесите до expireAt; для длительного хранения укажите storage: "persistent" при создании.

creatednumberОбязательно

Время создания задачи (Unix-секунды).

completednumberОбязательно

Unix-секунды терминального состояния; до этого — 0.

outputarrayНеобязательно

Только при status == success. Список артефактов — всегда массив; одна задача может вернуть несколько type сразу (напр. video + first_frame).

Array [ object ]

Элементы массива

urlstringОбязательно

URL артефакта, доступен для скачивания напрямую.

typestringОбязательно

Текущие возможные значения: video, image, audio, first_frame, last_frame, thumbnail; список может расширяться.

expireAtnumberОбязательно

Unix-секунды доступности артефакта; скачайте или перенесите до истечения.

errorobjectНеобязательно

Только при status == fail.

codestringОбязательно

Бизнес-код ошибки.

messagestringОбязательно

Описание ошибки.

Примеры ответа

Успех

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

Обработка (не финальное)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Ошибка

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}