Imagen a video

Usa CometAPI para llamar a Runway image_to_video y convertir la URL de una imagen fija en una salida de video sin procesar, con compatibilidad mediante X-Runway-Version.

POST /runwayml/v1/image_to_video

Create a Runway image-to-video task

cURL

curl --request POST \
  --url https://api.cometapi.com/runwayml/v1/image_to_video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Runway-Version: <x-runway-version>' \
  --data '
{
  "promptImage": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg",
  "model": "gen3a_turbo"
}
'

200

{
  "id": "3d957031-9a2a-45e2-9dc7-bc8513059c50"
}

Usa este endpoint para animar una imagen de origen en un video de Runway.

​

Antes de llamarlo

• Envía el encabezado X-Runway-Version obligatorio, por ejemplo 2024-11-06
• Usa model: gen3a_turbo
• Proporciona un promptImage HTTPS estable
• Comienza con duration: 5 y una proporción común como 1280:720

​

Flujo de la tarea

1. Enviar la solicitud de imagen a video

   Crea la tarea con una imagen de origen y un Prompt corto de movimiento opcional.

2. Guardar el id devuelto

   Guarda el id de la tarea para consultarlo más tarde.

3. Consultar el estado de la tarea

   Usa Get Task Details. Si la primera consulta devuelve task_not_exist, espera unos segundos y vuelve a intentarlo.

La validación en vivo del 2026-03-13 confirmó que se aceptó una solicitud mínima de gen3a_turbo y devolvió un id. Tras una breve espera, tanto los detalles oficiales de la tarea como el feed inverso devolvieron el mismo estado en cola encapsulado para esa tarea.

Autorizaciones

Authorization · string · header · requerido

Bearer token authentication. Use your CometAPI key.

Encabezados

X-Runway-Version · string · requerido

Runway version header, for example 2024-11-06.

Cuerpo

application/json

promptImage · string · predeterminado: https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg · requerido

Source image URL.

model · string · predeterminado: gen3a_turbo · requerido

Runway image-to-video model ID. Choose a current model from the Models page.

seed · integer

Random seed for reproducible results. Range: 0–999999999.

promptText · string

Text prompt describing the desired motion or scene. Maximum 512 characters.

watermark · boolean · predeterminado: false

Whether to add a watermark to the output video.

duration · integer · predeterminado: 5

Video duration in seconds. Accepted values: 5 or 10.

ratio · enum<string> · predeterminado: 1280:720

Aspect ratio of the output video.

Opciones disponibles: 1280:720, 720:1280, 1104:832, 832:1104, 960:960, 1584:672, 1280:768, 768:1280

Respuesta

200 - application/json

Task accepted.

id · string · requerido