Runway

Runway Gen 4.5

runway-gen-4.5/text-to-video

En el momento de su lanzamiento, encabeza la clasificación de texto a vídeo de Artificial Analysis con 1247 Elo; destaca en el seguimiento de instrucciones, la física y el movimiento humano, y es ideal para la creación de guiones gráficos audiovisuales y vídeos cortos de marca

runway-gen-4.5/image-to-video runway-gen-4.5/text-to-video

Probar runway-gen-4.5/text-to-video

Entrada

Creaciones

Ver todas las creaciones

Salida

video

Rellena los parámetros y genera: los resultados aparecerán aquí.

Precios

runway-gen-4.5/text-to-video per second

Precio unitario	$0.1715

Descripción general

La vía de generación de video a partir de texto Runway Gen-4.5 es un modelo de generación de video orientado a flujos de trabajo de imagen profesional: basta con introducir una indicación de texto para producir material de video final. Se ha optimizado especialmente en el seguimiento de indicaciones, la calidad del movimiento y el comportamiento físico; admite las relaciones de aspecto 16:9 y 9:16, y permite controlar la duración en tramos de 5, 8 y 10 segundos. Es adecuado para equipos de previsualización cinematográfica, cortometrajes de marca y exploración de diseño que necesitan convertir rápidamente descripciones de guion gráfico en imágenes evaluables, así como para desarrolladores que generan tomas por lotes dentro de flujos automatizados.

Aspectos clave

Seguimiento de indicaciones y calidad de movimiento mejorados: presenta mejoras evidentes en la ejecución de instrucciones y la expresividad dinámica frente a generaciones anteriores, por lo que las descripciones de cámara y acción llegan con mayor facilidad al video final.
Comportamiento físico y movimiento humano más naturales: modela con solidez procesos físicos complejos y movimientos humanos reales, ideal para tomas que requieren acciones creíbles.
Compatible con estilos realistas y estilizados: una misma vía puede producir imágenes de realismo fotográfico o expresiones visuales totalmente estilizadas, lo que facilita experimentar con estilos coherentes.
Relación de aspecto y duración definibles según la escena: admite salidas en 16:9 o 9:16 y ofrece tramos de 5, 8 y 10 segundos para adaptarse al formato de publicación.

Descripción de capacidades

Generación de video a partir de texto: con una indicación de hasta 1000 caracteres se puede generar un video, lo que permite convertir rápidamente texto de guion gráfico en material dinámico revisable.

Control de la duración: duration admite 5, 8 y 10 segundos, con 5 segundos por defecto; permite elegir la duración según el ritmo de la toma y reducir los recortes en posproducción.

Cambio entre formato horizontal y vertical: aspect_ratio admite 16:9 y 9:16, con 16:9 por defecto; una sola llamada produce material apto para publicación en pantalla horizontal o vertical.

Ejecución de descripciones de cámara y acción: muestra un alto grado de seguimiento de instrucciones de encuadre, movimiento y acción, de modo que los desarrolladores pueden describir el lenguaje cinematográfico con indicaciones estructuradas sin necesidad de ensayo y error repetidos.

Casos de uso

Equipos audiovisuales para previsualización y validación de guiones gráficos: generar tomas cortas a partir de descripciones textuales de guion gráfico para lecturas de guion, diseño de tomas y discusión de planes de rodaje.
Equipos de marketing de marca para generar material de video vertical: generar tomas de producto y escena en 9:16 y con duraciones de 5 o 10 segundos, listas para publicaciones de video corto en redes sociales.
Equipos de diseño para exploración de video conceptual: convertir conceptos creativos en indicaciones y generar por lotes fragmentos estilizados como referencia dinámica para propuestas y comparación de direcciones visuales.
Desarrolladores que construyen flujos de generación de video por lotes: enviar indicaciones y parámetros de relación de aspecto y duración mediante una interfaz unificada para integrar la capacidad de generación en canalizaciones automatizadas de producción de contenido.

Limitaciones y recomendaciones de selección

Los resultados generados aún pueden presentar errores en el orden causal, con efectos que aparecen antes que sus causas; los objetos pueden aparecer o desaparecer de la nada al cruzar fotogramas, y la coherencia temporal fluctúa; algunos resultados físicos y expresiones de movimiento se desvían de lo esperado, por lo que se requiere filtrar entre varias rondas de generación. Por ello, no es adecuado para la producción de largometrajes de calidad final que exijan una continuidad de tomas muy alta y no permitan revisión humana. Si una toma exige estrictamente estabilidad temporal o un comportamiento físico concreto, conviene preparar una alternativa o recurrir a un modelo más especializado.

Preguntas frecuentes

Ver todas las preguntas →

¿Cuáles son los requisitos para la imagen del primer fotograma?

Una por vez, en formato jpeg, png o webp, con un tamaño máximo de 10 MB por imagen; no se admite SVG. La relación de aspecto de la imagen debe coincidir preferiblemente con la del lienzo de salida; si las proporciones difieren, el primer fotograma se recortará desde el centro, por lo que es más seguro colocar el sujeto en el centro.
¿Se puede añadir un fotograma final?

No, este modelo solo utiliza un fotograma inicial; la imagen final la determinan el prompt y el modelo. Si necesitas especificar la imagen final, puedes usar Kling 2.5 Turbo Image-to-Video, que admite un fotograma final opcional.
¿Qué relaciones de aspecto y duraciones se pueden elegir? ¿Cuál es la resolución?

Relaciones de aspecto 16:9, 9:16, 4:3, 3:4 y 1:1, por defecto 16:9; duraciones de 5, 8 y 10 segundos, disponibles en todas las relaciones de aspecto, por defecto 5 segundos; resolución uniforme de 720p.
¿El video generado tiene sonido?

No incluye pista de audio; el video final solo contiene imagen, y la música y la voz en off se añaden durante la edición.

Crear una tarea de generación

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

Encabezados

AuthorizationstringObligatorio

Clave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API

Content-TypestringOpcional

El cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.

Idempotency-KeystringOpcional

Clave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.

Clave de idempotencia

Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.

Cuerpo

modelstringObligatorio

Valor fijo actual: runway-gen-4.5/text-to-video

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para runway-gen-4.5/text-to-video y la ruta default; consulta la tabla de parámetros a continuación.

promptstringObligatoriominLength 1maxLength 1000

Descripción textual del video, longitud máxima de 1000 caracteres.

durationintegerOpcionalPredeterminado: 5min 5max 10

Duración del video (en segundos), valor predeterminado 5. Cuando aspect_ratio es 9:16, solo se admiten 5/10; con otras relaciones de aspecto también se admiten 8 segundos, pero el modo fallback no puede generar solicitudes de 8 segundos.

Opciones:5810

aspect_ratiostringOpcionalPredeterminado: "16:9"

Relación de aspecto del video, valor predeterminado 16:9; cuando el valor es 9:16, solo se admiten duraciones de 5 o 10 segundos.

Opciones:16:99:16

callbackobjectOpcional

Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.

Callbacks (Webhook)

Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.

urlstringObligatorio

Obligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.

whenstringOpcionalPredeterminado: "final"

Actualmente solo se admite final: notifica tanto en success como en fail.

Opciones:final

storagestringOpcionalPredeterminado: "temp"

Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.

Opciones:temppersistent

Ejemplos de solicitud

# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "runway-gen-4.5/text-to-video",
  "input": {
    "prompt": "…",
    "duration": 5,
    "aspect_ratio": "16:9"
  }
}'

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: "runway-gen-4.5/text-to-video",
    input: {
      "prompt": "…",
      "duration": 5,
      "aspect_ratio": "16:9"
    }
  }),
});
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": "runway-gen-4.5/text-to-video",
        "input": {
          "prompt": "…",
          "duration": 5,
          "aspect_ratio": "16:9"
        }
    },
)
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"
}

Obtener el detalle de la tarea

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

Campos de respuesta

taskIdstringObligatorio

ID de tarea, siempre con prefijo tk-hiapi-.

modelstringObligatorio

Nombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.

routestringOpcional

Solo aparece si se usó el parámetro route explícito; repite el valor enviado.

statusstringObligatorio

Estado de la tarea.

Valores de estado

queued En cola, sin iniciar. handling Procesando. archiving Proceso terminado, preparando artefactos. success Terminal: completado, artefactos disponibles (se devuelve output). fail Terminal: error (se devuelve error). Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.

creatednumberObligatorio

Hora de creación de la tarea (segundos Unix).

completednumberObligatorio

Segundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.

outputarrayOpcional

Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).

Array [ object ]

Elementos del array

urlstringObligatorio

URL del artefacto, descargable directamente.

typestringObligatorio

Valores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.

expireAtnumberObligatorio

Segundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.

errorobjectOpcional

Solo con status == fail.

codestringObligatorio

Código de error de negocio.

messagestringObligatorio

Descripción del error.

Ejemplos de respuesta

Éxito

{
  "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
      }
    ]
  }
}

En proceso (no terminal)

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

Fallido

{
  "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"
    }
  }
}