Skip to main content
POST
cURL
Usa este endpoint para animar una imagen de origen en un video de Runway.

Antes de llamarlo

  • Envía el encabezado X-Runway-Version requerido, por ejemplo 2024-11-06
  • Usa model: gen3a_turbo
  • Proporciona un promptImage HTTPS estable
  • Comienza con duration: 5 y un valor de ratio compatible para el modelo/versión de Runway seleccionado

Duration y ratio

Las solicitudes en formato oficial de Runway usan ratio, no size. Interpreta los valores de ratio de estilo resolución como su equivalente WxH: 1280:720 corresponde a 1280x720, 720:1280 corresponde a 720x1280, y 1280:768 aún puede renderizarse como 1280x720 según el modelo/versión seleccionado.

Flujo de la tarea

1

Enviar la solicitud de imagen a video

Crea la tarea con una imagen de origen y un Prompt de movimiento corto 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 Obtener una tarea de Runway. Si la primera consulta devuelve task_not_exist, espera unos segundos y vuelve a intentarlo.

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 an available 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. Runway support is model/version dependent; use 5 or 10 for the broadest compatibility. CometAPI forwards this value to Runway.

ratio
string
predeterminado:1280:768

Requested output ratio. Accepted values are Runway model/version dependent. With X-Runway-Version 2024-11-06, use a resolution-style value accepted by the selected model, such as 1280:768, 768:1280, 1280:720, or 720:1280. Read these as WxH targets, but completed media may normalize, so inspect the returned file before relying on exact pixels.

Respuesta

200 - application/json

Task accepted.

id
string
requerido