Runway incorporó Eleven v4 a su API para desarrolladores el 30 de septiembre. La nota de lanzamiento 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 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 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 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 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:
{
"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 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 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 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 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 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 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 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 y su implementación del servicio 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, la lista de modelos y la guía de salida 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.
