¿Cómo usar la API de Runway Gen-4.5? Ten tu primer video listo en 5 minutos

TL;DR

• Runway Gen-4.5 es el modelo de video de Runway; en HiAPI tiene dos entradas, texto a video e imagen a video. Abre la página del modelo y pruébalo en línea; los usuarios nuevos reciben 200 créditos al registrarse.
• Ambas entradas cuestan $0.1715 por segundo: 5 segundos $0.8575, 8 segundos $1.372, 10 segundos $1.715.
• Cómo llamarlo: envía con POST /v1/tasks, consulta el resultado con taskId y el video final está en output[0].url.

Qué puede hacer Runway Gen-4.5

• Tres duraciones: 5, 8 y 10 segundos: 8 segundos alcanzan justo para un push-in, una órbita o una elevación lenta.
• 720p fijo: horizontal 1280×720, vertical 720×1280; no hay que elegir resolución.
• Imagen a video tiene 5 relaciones de aspecto: 16:9, 9:16, 4:3, 3:4, 1:1; una misma imagen puede generar versiones para distintas plataformas.
• El video final no tiene pista de audio: el modelo se encarga de la imagen; el sonido se añade en la edición.

She turns her head toward the camera and smiles, hair moves in a light breeze, slow push-in

Generar con este prompt → (sube un retrato como primer fotograma, elige 5 segundos y 3:4)

runway-gen-4.5/image-to-video, 3:4, 832×1104, 5 segundos, $0.8575. Primer fotograma: .

Ella gira la cabeza desde el perfil hacia la cámara y sonríe, un mechón de pelo se mueve, y la cámara avanza hasta un primer plano del rostro. El prompt solo describe la acción y el movimiento de cámara; la apariencia de la persona y la luz junto a la ventana provienen por completo del primer fotograma.

Cómo elegir entre las dos entradas

ID del modelo	Entrada	Duración	Relación de aspecto	Recomendado para
runway-gen-4.5/text-to-video	Prompt	5 / 8 / 10 segundos (9:16 solo 5 / 10)	16:9, 9:16	Sin material de partida, empezar desde texto
runway-gen-4.5/image-to-video	1 primer fotograma + prompt	5 / 8 / 10 segundos	16:9, 9:16, 4:3, 3:4, 1:1	Cuando el sujeto debe coincidir con la imagen original, o necesitas cuadrado, 4:3 o 3:4

Ambas entradas cuestan lo mismo: $0.1715 por segundo.

Dos rutas para empezar

Probar en el navegador (3 pasos)

1. Abre la página del modelo de texto a video o imagen a video e inicia sesión.
2. Escribe el prompt; para imagen a video, primero sube un primer fotograma.
3. Elige 5 segundos y la relación de aspecto, y pulsa ejecutar.

Llamar por API (3 pasos)

1. Crea una clave en la página de API Key de la consola y ponla en la variable de entorno HIAPI_KEY.
2. Envía con POST https://api.hiapi.ai/v1/tasks; devuelve data.taskId.
3. Consulta con GET /v1/tasks/{taskId} hasta que status sea success y descarga output[0].url.

curl: tu primer video

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "runway-gen-4.5/text-to-video",
    "input": {
      "prompt": "A lone stone lighthouse on a rugged sea cliff at dusk, heavy waves crashing against the rocks, the lamp beam sweeping across dark storm clouds, slow cinematic push-in, drifting sea mist, dramatic lighting",
      "duration": 5,
      "aspect_ratio": "16:9"
    }
  }'

5 segundos, 16:9, $0.8575. El video final queda así:

A lone stone lighthouse on a rugged sea cliff at dusk, heavy waves crashing against the rocks, the lamp beam sweeping across dark storm clouds, slow cinematic push-in, drifting sea mist, dramatic lighting

Generar con este prompt → (elige 5 segundos y 16:9)

runway-gen-4.5/text-to-video, 16:9, 1280×720, 5 segundos, $0.8575.

Python: enviar, consultar y descargar

# pip install requests; primero export HIAPI_KEY=tu Key
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(model, timeout_s=900, **inp):
    # Al reintentar la misma tarea, usa el mismo Idempotency-Key para evitar cargos duplicados
    r = requests.post(API, json={"model": model, "input": inp},
                      headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    r.raise_for_status()
    task_id = r.json()["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

# Imagen a video: versión 1:1 de la misma imagen, 8 segundos ($1.372)
url = generate(
    "runway-gen-4.5/image-to-video",
    prompt="The scene slowly comes alive: clouds drift, light shifts across the mountain lake, gentle forward camera move",
    image_urls=["https://tu-hosting-de-imagenes/lake.jpg"],
    duration=8, aspect_ratio="1:1",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Tabla de parámetros

Campo	Obligatorio	Valores	Descripción
prompt	Sí	1–1000 caracteres	Describe el sujeto, la acción y la cámara; en imagen a video solo la acción y la cámara
duration	No	5 (predeterminado) / 8 / 10	En texto a video 9:16 solo 5 / 10
aspect_ratio	No	Texto: 16:9 (predeterminado) 9:16; Imagen: 16:9 (predeterminado) 9:16 4:3 3:4 1:1	En imagen a video, el primer fotograma se recorta al centro según la relación de aspecto
image_urls	Obligatorio en imagen a video	Solo 1 imagen, jpeg/png/webp, ≤10MB	Primer fotograma; texto a video no acepta este campo

No hay resolution, seed ni negative_prompt, ni tampoco fotograma final.

Errores que encontrarás

Si los parámetros no son correctos al enviar, la API devuelve directamente 400, no crea la tarea y no cobra:

• duration: value must be one of 5, 10: elegiste 9:16 en texto a video y además enviaste 8 segundos.
• duration: value must be one of 5, 8, 10: la duración solo admite estas tres opciones.
• image_urls: maxItems: got 2, want 1: imagen a video solo acepta un primer fotograma, no admite fotograma final.
• image_urls: missing required field "image_urls": no enviaste el primer fotograma en imagen a video.
• prompt: maxLength: got 3,000, want 1,000: el prompt tiene un máximo de 1000 caracteres.
• additional properties 'negative_prompt', 'cfg_scale' not allowed: estos dos campos no existen en Runway Gen-4.5.

Antes de pasar a producción

• Usa callbacks en lugar de polling: en el nivel superior de la solicitud (al mismo nivel que input) añade "callback": {"url": "https://tu-dominio/hiapi/callback"} y deduplica por taskId.
• Guarda el video cuanto antes: output[0].url caduca en unos 7 días; guárdalo en tu propio almacenamiento en cuanto lo recibas.
• Especifica siempre duration y aspect_ratio: en texto a video vertical evita los 8 segundos; fijarlos en el código es lo más seguro.
• Reintenta con clave de idempotencia: añade Idempotency-Key en la cabecera; la misma clave solo crea una tarea.

Preguntas frecuentes

¿Puede generar 1080p o 4K?

No, la salida es fija a 720p. Si necesitas 1080p puedes usar Kling 2.5 Turbo; consulta la comparativa entre Runway Gen-4.5 y Kling 2.5 Turbo.

¿El video final tiene sonido?

No, la salida solo incluye imagen. La música, los efectos de sonido y la locución se añaden en la edición.

¿Se puede añadir un fotograma final en imagen a video?

No, image_urls solo acepta una imagen. Si necesitas controlar el final con un fotograma final, usa imagen a video de Kling 2.5 Turbo.

¿Qué pasa si la relación de aspecto del primer fotograma no coincide con la elegida?

El primer fotograma se recorta al centro según la relación de aspecto seleccionada; lo más seguro es colocar el sujeto en el centro.

Para ver el desglose de precios, consulta Precios de la API de Runway Gen-4.5, y para más casos de uso, Guía completa de prompts de Runway Gen-4.5. Si quieres ver el resultado primero, copia el prompt del faro de arriba y ve a la página del modelo para generar tu primer video.