Runway

Runway Gen 4.5

runway-gen-4.5/image-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/image-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/image-to-video per second

Precio unitario	$0.1715

Descripción general

Línea de imagen a vídeo de Runway Gen-4.5: partiendo de una imagen de primer fotograma y junto con una descripción de acciones y movimientos de cámara, genera vídeos de 5, 8 o 10 segundos. Mantiene las ventajas de esta serie en cuanto al seguimiento de prompts y la calidad del movimiento, y resulta adecuada para previsualización audiovisual, publicidad y exploración de diseño en las que se necesita extender una imagen de referencia, un concept art o una imagen de producto hacia una toma dinámica; se invoca a través de la interfaz unificada de HiAPI.ai y se factura según los segundos de salida.

Puntos clave

El primer fotograma ancla el punto de partida de la imagen: una sola imagen como entrada de primer fotograma; la imagen de salida se extiende a partir de ella, lo que reduce la deriva de composición que provoca la generación puramente textual.
Duración y relación de aspecto ajustables según los requisitos de entrega: admite tres duraciones de 5, 8 y 10 segundos y cinco relaciones de aspecto; la imagen de primer fotograma se recorta centrada según la relación elegida.
El prompt describe el movimiento en lugar de redibujar la imagen: el prompt se centra en la descripción de acciones y posición de cámara; el sujeto de la imagen lo determina el primer fotograma, con una clara división de tareas entre instrucción e imagen.

Descripción de capacidades

Generación de vídeo guiada por el primer fotograma: sube una imagen jpeg, png o webp como primer fotograma (límite de 10 MB) y el modelo genera a partir de ella un vídeo dinámico, adecuado para fases de producción con una composición ya definida que necesitan completar el movimiento.

Control de instrucciones de movimiento y cámara: el prompt se emplea para describir acciones y movimientos de cámara, con un límite de 1000 caracteres, lo que facilita escribir directamente en los parámetros de generación la posición de cámara y la intención de puesta en escena del storyboard.

Duración y relación de aspecto parametrizadas: permite elegir duraciones de 5, 8 y 10 segundos, así como relaciones de aspecto 16:9, 9:16, 4:3, 3:4 y 1:1, cubriendo necesidades de publicación en horizontal, vertical y cuadrado.

Casos de uso

Guionistas gráficos de cine y publicidad: generar tomas de previsualización a partir de fotogramas clave: usa el fotograma clave del storyboard como primer fotograma para generar clips de previsualización de varios segundos con movimiento de cámara, destinados a la revisión interna y a confirmar el ritmo de las tomas.
Diseño de marca y comercio electrónico: convertir imágenes de producto en presentaciones dinámicas: genera vídeos cortos usando la imagen de referencia del producto como primer fotograma, para espacios de material vertical o cuadrado en páginas de detalle y anuncios en feed.
Equipos de diseño conceptual: explorar la expresión dinámica de bocetos estáticos: extiende el concept art a clips dinámicos breves para comparar rápidamente distintas propuestas de movimiento antes de decidir la dirección que pasa a producción formal.

Limitaciones y recomendaciones de selección

Como línea de imagen a vídeo, el sujeto de la imagen lo determina el primer fotograma y el prompt solo controla el movimiento y la cámara, sin poder modificar la composición ni el contenido del primer fotograma; el primer fotograma solo admite una única imagen y no admite SVG. En tomas complejas aún pueden aparecer desviaciones en el orden causal y en la consistencia de objetos entre fotogramas; para tomas que impliquen cambios importantes de composición o narración de larga secuencia temporal, se recomienda dividirlas en partes, reservar coste para regeneraciones o recurrir a un método de generación más adecuado.

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/image-to-video

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

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

promptstringObligatoriominLength 1maxLength 1000

Indicación de texto que describe el movimiento de la imagen y el movimiento de cámara, en formato de cadena, máximo 1000 caracteres.

durationintegerOpcionalPredeterminado: 5min 5max 10

Duración del vídeo generado, en número entero, en segundos, por defecto 5.

Opciones:5810

image_urlsarrayObligatoriominItems 1maxItems 1

Matriz de imágenes del primer fotograma, la matriz es de un solo elemento y el elemento es una URL de imagen; admite formatos jpeg/png/webp, máximo 10MB por imagen, no admite SVG.

Array [ string ]

aspect_ratiostringOpcionalPredeterminado: "16:9"

Relación de aspecto del vídeo de salida, en formato de cadena, por defecto 16:9; la imagen del primer fotograma se recortará centrada según esta relación.

Opciones:16:99:164:33:41:1

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/image-to-video",
  "input": {
    "prompt": "…",
    "duration": 5,
    "image_urls": "…",
    "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/image-to-video",
    input: {
      "prompt": "…",
      "duration": 5,
      "image_urls": "…",
      "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/image-to-video",
        "input": {
          "prompt": "…",
          "duration": 5,
          "image_urls": "…",
          "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"
    }
  }
}