Skip to main content
POST
cURL
Usa este endpoint para transformar un clip de origen existente con el flujo de trabajo de video a video de Runway. Inicia una tarea asíncrona en lugar de devolver el resultado final de inmediato.

Antes de llamarlo

  • Prepara un video de origen que cumpla con los requisitos de entrada del proveedor
  • Incluye el encabezado X-Runway-Version obligatorio para el conjunto de funciones que deseas
  • Comienza con un Prompt corto que describa el cambio, no con un storyboard completo

Relación de aspecto de salida

Este endpoint espera valores de ratio separados por dos puntos. Usa 1280:720 para salida 1280x720 y 720:1280 para 720x1280; 1280x720 no se acepta en todas las rutas de video a video de Runway.

Flujo de la tarea

1

Enviar el clip de origen y el Prompt

Inicia la tarea desde este endpoint y guarda el id de tarea devuelto.
2

Consultar los detalles de la tarea

Usa Obtener una tarea de Runway hasta que la tarea alcance un estado terminal.
3

Almacenar el resultado transformado

Descarga o conserva el recurso finalizado a través de tu canalización de medios habitual.

Autorizaciones

Authorization
string
header
requerido

Bearer token authentication. Use your CometAPI key.

Encabezados

X-Runway-Version
string
requerido

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

Cuerpo

application/json
videoUri
string
predeterminado:https://your-video-host/source.mp4
requerido

HTTPS URL of the source video, or a base64 data URI containing the video.

promptText
string
predeterminado:A cat yawning in slow motion.
requerido

Text prompt describing the desired output. Maximum 1000 characters.

seed
integer
predeterminado:1
requerido

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

model
string
predeterminado:gen4_aleph
requerido

Model variant to use.

references
object[]
requerido

Optional reference images to guide generation. Each item must include type (e.g. image) and uri (HTTPS URL).

ratio
string
predeterminado:1280:720
requerido

Requested output frame shape. Use colon-separated values such as 1280:720 or 720:1280; read them as 1280x720 and 720x1280 targets. Do not assume every Runway video-to-video route accepts 1280x720 with an x separator.

contentModeration
object
requerido

Respuesta

200 - application/json

success

id
string
requerido

The ID of the task that was created. Use this to retrieve the task later.