Версия Markdown

AI-translated from English; not yet reviewed by a fluent editor.

# Речевой API Runway Eleven v4: формат запроса и цены в октябре

> Речевой API Runway Eleven v4 принимает сценарии длиной до 2 500 символов. В этом руководстве на основе документации объясняются запрос, результат задачи, настройка аккаунта и изменение цены 12 октября.

By BIG CHANGE Editorial

Published: 2026-10-06T06:30:01.909Z
Updated: 2026-10-06T06:30:01.909Z
Canonical: https://bigchange.ai/blog/runway-eleven-v4-text-to-speech-api-price-change

![Conceptual charcoal illustration of unbranded headphones resting beside a loose script sheet with abstract text strokes.](https://bigchange.ai/api/media/file/runway-eleven-script-audio-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE. A written script and headphones represent text-to-speech; no API test or audio assessment is depicted.

30 сентября Runway добавила Eleven v4 в свой API для разработчиков. [В примечании к выпуску](https://docs.dev.runwayml.com/api-details/api_changelog/) модель указана как `eleven_v4`, длина сценария ограничена 2 500 символами, а стоимость в кредитах, как сообщается, вырастет 12 октября 2026 года по тихоокеанскому времени. Разработчикам, которые добавляют генерацию речи в рабочий процесс, важно понять, что требуется для корректного запроса и сколько документированный тариф составляет в долларах. Это руководство основано на документации Runway, проверенной 6 октября; BIG CHANGE не отправляла платный запрос к API и не оценивала аудио.

## Главное изменение

- **Что изменилось:** Теперь Runway указывает Eleven v4 как модель преобразования текста в речь для своего существующего API задач. В сценарий можно включить документированные аудиотеги, например `[laughs]`, `[whispers]` и `[pause]`, не выходя за предел 2 500 символов.
- **Почему это важно:** Команда с проектом разработчика в Runway может запросить речь с помощью предустановленного голоса и получить URL аудио завершённой задачи. Для планирования интеграции и бюджета можно использовать документированный формат запроса и расписание цен с указанными датами.
- **За чем следить:** Runway сообщает, что 12 октября 2026 года по тихоокеанскому времени тариф изменится с 2,2 до 5 кредитов за 1 000 символов. При оценке многократной генерации нужно учитывать тариф, действующий на момент выставления счёта, и проверять текущую цену до утверждения бюджета.

## Настройте проект и ключ

В [руководстве по настройке](https://docs.dev.runwayml.com/guides/setup/) Runway рекомендуется создать аккаунт и проект на портале разработчика, а затем создать ключ API проекта в разделе API Keys. Для создания или отключения ключа нужна роль Admin или Developer. Ключ показывается в открытом виде только один раз, поэтому храните его безопасно. Для работы с SDK Runway рекомендует задать `RUNWAYML_API_SECRET`; SDK автоматически считывает эту переменную. Не помещайте секрет в исходный код.

Для работы с API проекту также нужны кредиты. По данным Runway, минимальный первоначальный платёж составляет **$10** при цене **$0.01 за кредит**; оплатить его можно на вкладке выставления счетов проекта. Для добавления кредитов нужна роль Admin или Billing admin. Это минимальная покупка кредитов, а не стоимость одного речевого запроса. На странице настройки бесплатный первый вызов не упоминается.

## Отправьте запрос на преобразование текста в речь

Текущий тип запроса в [Python SDK Runway](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/types/text_to_speech_create_params.py) требует `model`, `prompt_text` и объект `voice` для Eleven v4. В JSON-запросе им соответствуют поля `model`, `promptText` и `voice`, где `voice.type` задан как `runway-preset` и передан объект `presetId`. `Bernard` — один из перечисленных предустановленных голосов. [Сервис SDK](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/resources/text_to_speech.py) отправляет этот запрос на `/v1/text_to_speech` и возвращает ответ с новой задачей. В [руководстве по API](https://docs.dev.runwayml.com/guides/using-the-api/) Runway описаны хост, bearer-ключ и заголовок `X-Runway-Version: 2024-11-06` для прямых HTTP-вызовов.

Это тело запроса, составленное по документации, а не выполненный нами вызов:

```json
{
  "model": "eleven_v4",
  "promptText": "The recording begins now. [pause] Welcome.",
  "voice": {
    "type": "runway-preset",
    "presetId": "Bernard"
  }
}
```

В записи Runway от 30 сентября в [журнале изменений](https://docs.dev.runwayml.com/api-details/api_changelog/) перечислены `[laughs]`, `[whispers]` и `[pause]` как поддерживаемые примеры. Там также сказано, что Eleven v4 использует те же предустановленные голоса Runway, что и Eleven v3. Теги входят в сценарий, поэтому оставьте для них место в пределах указанного максимума в 2 500 символов. В SDK также перечислены необязательные настройки голоса, язык и соседние текстовые поля. Схема не доказывает, что какая-либо настройка гарантирует определённую манеру речи; в статье также не делается выводов о качестве голоса или задержке.

Первоначальный ответ — это задача, а не аудиоданные. В [руководстве по выходным данным](https://docs.dev.runwayml.com/assets/outputs/) Runway рекомендуется отправить запрос `GET /v1/tasks/:id`; успешно завершённая задача содержит массив URL-адресов результатов `output`. Эти URL-адреса перестают действовать через 24–48 часов после обращения к API, поэтому сохраните результат в собственном хранилище, а не используйте временный адрес в продукте. В общем примере выходных данных показана видеозадача: он подтверждает структуру ответа задачи, тогда как [список моделей](https://docs.dev.runwayml.com/guides/models/) указывает, что результат Eleven v4 — аудио. Мы не наблюдали ответ Eleven v4 и не проверяли формат его аудиофайла.

## Рассчитайте цену с учётом даты

На [странице цен](https://docs.dev.runwayml.com/guides/pricing/) Runway и в примечании к выпуску указаны **2,2 кредита за 1 000 символов до 12 октября 2026 года по тихоокеанскому времени**, а после этой даты — **5 кредитов за 1 000 символов**; минимум составляет **один кредит**. При опубликованной цене $0.01 за кредит эти тарифы равны **$0.022** и **$0.05 за 1 000 символов** без учёта применимых налогов. Новый указанный тариф примерно в 2,27 раза выше прежнего.

Прозрачный пример для планирования: десять отдельных сценариев, каждый ровно по 1 000 оплачиваемых символов, составят 10 000 символов. Расчёт по опубликованным тарифам даёт **22 кредита, или $0.22** по прежнему тарифу и **50 кредитов, или $0.50** по новому тарифу. Каждый сценарий короче лимита в 2 500 символов, а стоимость каждого рассчитанного запроса превышает минимум в один кредит. Это арифметический расчёт по указанным Runway тарифам, а не фактический счёт. В цитируемых материалах не сказано, как теги учитываются в оплачиваемых символах и округляются ли дробные начисления за запрос. Поэтому при планировании производства следует проверять фактические данные об использовании и актуальные условия.

## Источники и дополнительная литература

В [журнале изменений API от 30 сентября](https://docs.dev.runwayml.com/api-details/api_changelog/) Runway указаны дата выпуска, ID модели, примеры тегов, ограничение длины сценария и датированное заявление о цене. В [руководстве по настройке](https://docs.dev.runwayml.com/guides/setup/) описаны требования к проекту, ключу и кредитам, в том числе разрешения для ролей и первоначальный платёж $10. На [странице цен](https://docs.dev.runwayml.com/guides/pricing/) приведены перевод кредитов в доллары и указанные тарифы Eleven v4.

В [схеме запроса Python SDK](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/types/text_to_speech_create_params.py) и [реализации сервиса](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/resources/text_to_speech.py) указаны названия полей, формат предустановленного голоса, путь конечной точки и ответ о создании задачи, проверенные для этого руководства. [Руководство для начала работы](https://docs.dev.runwayml.com/guides/using-the-api/), [список моделей](https://docs.dev.runwayml.com/guides/models/) и [руководство по выходным данным](https://docs.dev.runwayml.com/assets/outputs/) Runway описывают заголовок версии HTTP, тип аудиовыхода и получение задачи. Это документы поставщика, а не независимая проверка производительности. Проверено 6 октября 2026 года.

## Sources

- [Журнал изменений Runway Dev API: Eleven v4](https://docs.dev.runwayml.com/api-details/api_changelog/) — В записи Runway от 30 сентября объявлены eleven_v4, ограничение сценария в 2 500 символов, три примера аудиотегов, предустановленные голоса Runway и изменение 12 октября по тихоокеанскому времени с 2,2 до 5 кредитов за 1 000 символов при минимуме в один кредит. Запись не подтверждает качество аудио или успешный вызов BIG CHANGE.
- [Настройка Runway Dev API](https://docs.dev.runwayml.com/guides/setup/) — Описывает требования к аккаунту, проекту, ключу API и роли; секретную переменную окружения для SDK; и минимальную первоначальную покупку кредитов на $10 по цене $0.01 за кредит. Это инструкции поставщика, а не шаги, проверенные в статье.
- [Цены Runway Dev API](https://docs.dev.runwayml.com/guides/pricing/) — Указывает два датированных тарифа кредитов для Eleven v4 и цену $0.01 за кредит. Пример $0.22 и $0.50 в статье — расчёт для десяти запросов по 1 000 символов, а не фактический счёт; может взиматься налог с продаж.
- [Python SDK Runway: схема запроса на преобразование текста в речь](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/types/text_to_speech_create_params.py) — В текущей основной ветке официального SDK ElevenV4 указан как обязательная модель, promptText — как псевдоним, а голос Runway preset — с presetId; Bernard присутствует в списке. Основная ветка может измениться, запрос не выполнялся.
- [Python SDK Runway: сервис преобразования текста в речь](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/resources/text_to_speech.py) — Текущий официальный сервис SDK отправляет запрос на /v1/text_to_speech и возвращает ответ с новой задачей. Это не демонстрирует наблюдавшийся ответ Eleven v4.
- [Runway Dev: использование API](https://docs.dev.runwayml.com/guides/using-the-api/) — В примерах генерации описаны хост API, bearer-ключ, заголовок X-Runway-Version 2024-11-06 и формат ID задачи. Проверенные примеры не являются вызовами Eleven v4.
- [Runway Dev: форматы выходных данных](https://docs.dev.runwayml.com/assets/outputs/) — Описывает GET /v1/tasks/:id, массивы URL результатов успешных задач и срок действия URL в 24–48 часов. В показанном примере используется видеозадача, поэтому формат аудио Eleven v4 из него не выводится.
- [Runway Dev: доступные модели](https://docs.dev.runwayml.com/guides/models/) — Указывает для eleven_v4 текстовый вход и аудиовыход. Это классификация модели, а не независимая проверка аудио.