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

30 сентября Runway добавила Eleven v4 в свой API для разработчиков. В примечании к выпуску модель указана как 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 символов. При оценке многократной генерации нужно учитывать тариф, действующий на момент выставления счёта, и проверять текущую цену до утверждения бюджета.

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

В руководстве по настройке Runway рекомендуется создать аккаунт и проект на портале разработчика, а затем создать ключ API проекта в разделе API Keys. Для создания или отключения ключа нужна роль Admin или Developer. Ключ показывается в открытом виде только один раз, поэтому храните его безопасно. Для работы с SDK Runway рекомендует задать RUNWAYML_API_SECRET; SDK автоматически считывает эту переменную. Не помещайте секрет в исходный код.

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

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

Текущий тип запроса в Python SDK Runway требует model, prompt_text и объект voice для Eleven v4. В JSON-запросе им соответствуют поля model, promptText и voice, где voice.type задан как runway-preset и передан объект presetId. Bernard — один из перечисленных предустановленных голосов. Сервис SDK отправляет этот запрос на /v1/text_to_speech и возвращает ответ с новой задачей. В руководстве по API Runway описаны хост, bearer-ключ и заголовок X-Runway-Version: 2024-11-06 для прямых HTTP-вызовов.

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

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

В записи Runway от 30 сентября в журнале изменений перечислены [laughs], [whispers] и [pause] как поддерживаемые примеры. Там также сказано, что Eleven v4 использует те же предустановленные голоса Runway, что и Eleven v3. Теги входят в сценарий, поэтому оставьте для них место в пределах указанного максимума в 2 500 символов. В SDK также перечислены необязательные настройки голоса, язык и соседние текстовые поля. Схема не доказывает, что какая-либо настройка гарантирует определённую манеру речи; в статье также не делается выводов о качестве голоса или задержке.

Первоначальный ответ — это задача, а не аудиоданные. В руководстве по выходным данным Runway рекомендуется отправить запрос GET /v1/tasks/:id; успешно завершённая задача содержит массив URL-адресов результатов output. Эти URL-адреса перестают действовать через 24–48 часов после обращения к API, поэтому сохраните результат в собственном хранилище, а не используйте временный адрес в продукте. В общем примере выходных данных показана видеозадача: он подтверждает структуру ответа задачи, тогда как список моделей указывает, что результат Eleven v4 — аудио. Мы не наблюдали ответ Eleven v4 и не проверяли формат его аудиофайла.

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

На странице цен 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 сентября Runway указаны дата выпуска, ID модели, примеры тегов, ограничение длины сценария и датированное заявление о цене. В руководстве по настройке описаны требования к проекту, ключу и кредитам, в том числе разрешения для ролей и первоначальный платёж $10. На странице цен приведены перевод кредитов в доллары и указанные тарифы Eleven v4.

В схеме запроса Python SDK и реализации сервиса указаны названия полей, формат предустановленного голоса, путь конечной точки и ответ о создании задачи, проверенные для этого руководства. Руководство для начала работы, список моделей и руководство по выходным данным Runway описывают заголовок версии HTTP, тип аудиовыхода и получение задачи. Это документы поставщика, а не независимая проверка производительности. Проверено 6 октября 2026 года.