Edición en Markdown

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

# API de voz Eleven v4 de Runway: formato de solicitud y precios de octubre

> La API de voz Eleven v4 de Runway acepta guiones de hasta 2.500 caracteres. Esta guía basada en la documentación explica la solicitud, el resultado de la tarea, la configuración de la cuenta y el cambio de precios del 12 de octubre.

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.

Runway incorporó Eleven v4 a su API para desarrolladores el 30 de septiembre. La [nota de lanzamiento](https://docs.dev.runwayml.com/api-details/api_changelog/) identifica el modelo como `eleven_v4`, limita cada guion a 2.500 caracteres e indica que la tarifa en créditos subirá el 12 de octubre de 2026, hora del Pacífico. Para quienes integran generación de voz en un flujo de producción, la cuestión práctica es qué necesita una solicitud válida y cuánto representa en dólares la tarifa documentada. Esta guía se basa en la documentación de Runway consultada el 6 de octubre; BIG CHANGE no realizó una llamada de pago a la API ni evaluó el audio.

## El gran cambio

- **Qué cambió:** Runway ahora incluye Eleven v4 como modelo de texto a voz detrás de su API de tareas existente. Un guion puede incluir etiquetas de audio documentadas, como `[laughs]` , `[whispers]` y `[pause]`, dentro del límite de 2.500 caracteres.
- **Por qué importa:** Un equipo con un proyecto de desarrollador de Runway puede solicitar voz con una voz predefinida y recuperar la URL de audio de la tarea completada. La integración y la planificación del presupuesto pueden basarse en un formato de solicitud documentado y un calendario de precios con fecha.
- **Qué observar:** Runway indica que la tarifa cambiará de 2,2 a 5 créditos por cada 1.000 caracteres el 12 de octubre de 2026, hora del Pacífico. Quien calcule generaciones repetidas debe aplicar la tarifa vigente cuando se facture la solicitud y comprobar el precio actual antes de comprometer un presupuesto.

## Configurar un proyecto y una clave

La [guía de configuración](https://docs.dev.runwayml.com/guides/setup/) de Runway indica que hay que crear una cuenta y un proyecto en el portal de desarrolladores, y luego crear una clave API de proyecto en API Keys. Para crear o desactivar una clave se requiere el rol de Admin o Developer. La clave aparece en texto sin cifrar una sola vez, así que debe guardarse de forma segura. Para usar el SDK, Runway indica que se configure `RUNWAYML_API_SECRET`; el SDK lee esa variable automáticamente. Mantén el secreto fuera del código fuente.

El proyecto también necesita créditos para usar la API. Runway indica que el pago inicial mínimo es de **$10**, a **$0,01 por crédito**, desde la pestaña de facturación del proyecto. Para añadir créditos se necesita el rol de Admin o Billing admin. Es una compra mínima de créditos, no el cargo por una solicitud de voz. La página de configuración no describe una primera llamada gratuita.

## Enviar una solicitud de texto a voz

El [tipo de solicitud actual del SDK de Python de Runway](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/types/text_to_speech_create_params.py) requiere `model`, `prompt_text` y un objeto `voice` para Eleven v4. En la transmisión, los campos JSON correspondientes son `model`, `promptText` y `voice`, con `voice.type` establecido en `runway-preset` y un objeto `presetId`. `Bernard` es una de las voces predefinidas enumeradas. El [servicio del SDK](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/resources/text_to_speech.py) envía esta solicitud a `/v1/text_to_speech` y devuelve una nueva respuesta de tarea. La documentación de Runway incluye la [guía de la API](https://docs.dev.runwayml.com/guides/using-the-api/) y documenta el host, la clave bearer y el encabezado `X-Runway-Version: 2024-11-06` que se usa en las llamadas HTTP directas.

Este es un cuerpo de solicitud derivado de la documentación, no una llamada que hayamos ejecutado:

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

La [entrada del registro de cambios del 30 de septiembre](https://docs.dev.runwayml.com/api-details/api_changelog/) de Runway enumera `[laughs]`, `[whispers]` y `[pause]` como ejemplos admitidos e indica que Eleven v4 usa las mismas voces predefinidas de Runway que Eleven v3. Las etiquetas forman parte del guion; hay que dejarles espacio dentro del máximo declarado de 2.500 caracteres. El SDK también enumera ajustes de voz opcionales, el idioma y campos de texto adyacentes. El esquema no demuestra que ningún ajuste garantice una interpretación concreta, y este artículo no afirma nada sobre la calidad de la voz ni la latencia.

La respuesta inicial es una tarea, no bytes de audio. La [guía de salida](https://docs.dev.runwayml.com/assets/outputs/) indica que se consulte `GET /v1/tasks/:id`; una tarea completada correctamente contiene un array `output` con las URL de los resultados. Caducan entre 24 y 48 horas después de acceder a la API; descarga el resultado a tu propio almacenamiento en vez de usar la URL temporal en un producto. El ejemplo general de salida es una tarea de vídeo y establece el formato de respuesta de la tarea; la [lista de modelos](https://docs.dev.runwayml.com/guides/models/) identifica la salida de Eleven v4 como audio. No hemos observado una respuesta de Eleven v4 ni verificado el formato del archivo de audio.

## Calcular el precio según la fecha

La [página de precios](https://docs.dev.runwayml.com/guides/pricing/) y la nota de lanzamiento indican **2,2 créditos por cada 1.000 caracteres hasta el 12 de octubre de 2026, hora del Pacífico**, después **5 créditos por cada 1.000 caracteres**, con un **mínimo de un crédito**. Al precio publicado de $0,01 por crédito, las tarifas equivalen a **$0,022** y **$0,05 por cada 1.000 caracteres**, antes de los impuestos aplicables. La tarifa posterior es aproximadamente 2,27 veces la anterior.

Ejemplo transparente para planificar: diez guiones distintos de exactamente 1.000 caracteres facturables suman 10.000 caracteres. Al multiplicar las tarifas publicadas se obtienen **22 créditos, o $0,22**, con la tarifa anterior, y **50 créditos, o $0,50**, con la nueva. Cada guion queda por debajo del límite de 2.500 caracteres y cada solicitud calculada supera el mínimo de un crédito. Es un cálculo basado en las tarifas publicadas por Runway, no una factura observada. Las páginas citadas no especifican cómo cuentan las etiquetas para los caracteres facturables ni si se redondean los cargos fraccionarios por solicitud; para estimar el coste en producción conviene revisar los registros de uso reales y las condiciones vigentes.

## Fuentes y lecturas adicionales

La [cronología de cambios de la API del 30 de septiembre](https://docs.dev.runwayml.com/api-details/api_changelog/) de Runway establece la fecha de lanzamiento, el ID del modelo, ejemplos de etiquetas, el límite del guion y la tarifa fechada. La [guía de configuración](https://docs.dev.runwayml.com/guides/setup/) explica los requisitos de proyecto, clave y créditos, incluidos los permisos por rol y el pago inicial de $10. La [página de precios](https://docs.dev.runwayml.com/guides/pricing/) ofrece la conversión de créditos a dólares y las tarifas indicadas para Eleven v4.

El [esquema de solicitud del SDK de Python](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/types/text_to_speech_create_params.py) y su [implementación del servicio](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/resources/text_to_speech.py) establecen los nombres de los campos, el formato de voz predefinida, la ruta del endpoint y la respuesta de creación de tareas que se consultaron para esta guía. La [guía de inicio](https://docs.dev.runwayml.com/guides/using-the-api/), la [lista de modelos](https://docs.dev.runwayml.com/guides/models/) y la [guía de salida](https://docs.dev.runwayml.com/assets/outputs/) proporcionan el encabezado de versión HTTP, la clasificación de salida de audio y el funcionamiento de la consulta de tareas. Son documentos del proveedor, no una prueba independiente de rendimiento. Consultados el 6 de octubre de 2026.

## Sources

- [Runway Dev API, registro de cambios: Eleven v4](https://docs.dev.runwayml.com/api-details/api_changelog/) — La entrada de Runway del 30 de septiembre anuncia eleven_v4, el límite de 2.500 caracteres para el guion, tres ejemplos de etiquetas de audio, las voces predefinidas de Runway y el cambio del 12 de octubre, hora del Pacífico, de 2,2 a 5 créditos por cada 1.000 caracteres con un mínimo de un crédito. No demuestra la calidad del audio ni que BIG CHANGE haya realizado una llamada con éxito.
- [Runway Dev API, configuración](https://docs.dev.runwayml.com/guides/setup/) — Documenta los requisitos de cuenta, proyecto, clave API y roles; la variable de entorno secreta del SDK; y la compra inicial mínima de $10 en créditos a $0,01 por crédito. Son instrucciones del proveedor, no pasos probados por este artículo.
- [Runway Dev API, precios](https://docs.dev.runwayml.com/guides/pricing/) — Enumera las dos tarifas fechadas en créditos de Eleven v4 y el precio de $0,01 por crédito. El ejemplo del artículo de $0,22 y $0,50 es un cálculo para diez solicitudes de 1.000 caracteres, no una factura observada; pueden aplicarse impuestos sobre las ventas.
- [Runway Python SDK: esquema de solicitud de texto a voz](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/types/text_to_speech_create_params.py) — La rama principal actual del SDK oficial define ElevenV4 como modelo obligatorio, promptText como alias y una voz predefinida de Runway con presetId; Bernard figura en la lista. La rama principal puede cambiar y la solicitud no se ejecutó.
- [Runway Python SDK: servicio de texto a voz](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/resources/text_to_speech.py) — El servicio actual del SDK oficial envía solicitudes a /v1/text_to_speech y devuelve una respuesta con una tarea nueva. No demuestra una respuesta observada de Eleven v4.
- [Runway Dev: uso de la API](https://docs.dev.runwayml.com/guides/using-the-api/) — Documenta el host de la API, la clave bearer, el encabezado X-Runway-Version 2024-11-06 y el patrón de ID de tarea en ejemplos de generación. Los ejemplos consultados no son llamadas a Eleven v4.
- [Runway Dev: formatos de salida](https://docs.dev.runwayml.com/assets/outputs/) — Describe GET /v1/tasks/:id, arrays de URL de salida para tareas completadas correctamente y una caducidad de URL de 24 a 48 horas. El ejemplo mostrado es una tarea de vídeo, así que no se infiere ningún formato de audio para Eleven v4.
- [Runway Dev: modelos disponibles](https://docs.dev.runwayml.com/guides/models/) — Incluye eleven_v4 como entrada de texto y salida de audio. Es una clasificación del modelo, no una inspección independiente del audio.