Crea una tarea de imagen a vídeo de Runway

POST

runwayml

image_to_video

curl "https://api.cometapi.com/runwayml/v1/image_to_video" \
  --request POST \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "gen4.5",
  "promptImage": "https://upload.wikimedia.org/wikipedia/commons/3/3a/Cat03.jpg",
  "promptText": "The cat turns toward the camera.",
  "ratio": "1280:720",
  "duration": 5
}'

{
  "id": "00000000-0000-4000-8000-000000000001"
}

{
  "code": "<string>",
  "message": "<string>",
  "data": "<unknown>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Usa este endpoint para animar una imagen de origen. Envía tu clave de API de CometAPI con autenticación Bearer y un cuerpo de solicitud JSON.

Elige un modelo

Modelo	Campos obligatorios	Prompt de movimiento
`gen4.5`	`model`, `promptImage`, `promptText`, `ratio`, `duration`	Describe el movimiento en `promptText`.
`gen4_turbo`	`model`, `promptImage`, `ratio`	Opcionalmente, describe el movimiento en `promptText`, usando de 1 a 1000 unidades de código UTF-16.

Para una solicitud de solo texto, usa Crea una tarea de texto a vídeo de Runway.

Proporciona el primer fotograma

Establece promptImage en una URL de imagen HTTPS accesible o un URI de datos de imagen Base64. También puedes proporcionar una matriz de un elemento que contenga uri y position: "first". Esta interfaz acepta un fotograma inicial; no agregues una entrada de último fotograma. Las imágenes HTTPS deben ser directamente accesibles sin redireccionamientos y tener encabezados válidos de contenido de imagen. Los URI de datos de imagen codificados pueden tener hasta 5 MB. Consulta los requisitos de entrada de medios de Runway para conocer los formatos y las dimensiones de imagen.

Establece la duración y las dimensiones

Usa un duration de número entero de 2 a 10 segundos. Es obligatorio para gen4.5 y opcional para gen4_turbo. Establece ratio en 1280:720, 720:1280, 1104:832, 960:960, 832:1104 o 1584:672. Estos son valores de ancho y alto separados por dos puntos. Para una semilla de muestreo explícita, usa 1 de 4294967295. La omisión o 0 selecciona una semilla aleatoria. Si incluyes contentModeration, establece su publicFigureThreshold en auto o low; de lo contrario, omite el objeto.

Elige un formato de salida

gen4.5 acepta outputFormat para MP4, ProRes, secuencias PNG y los formatos HDR enumerados en el esquema de solicitud. Omite el campo para H.264 MP4. proresProfile se aplica solo a prores y hdr_prores; sus valores permitidos dependen del formato seleccionado. Omite ambos campos con gen4_turbo.

Recupera el resultado

Guarda el id devuelto y usa Obtén una tarea de Runway. Cuando status sea SUCCEEDED, consulta las URL de resultados en output.

Autorizaciones

Authorization

string

header

requerido

Use your CometAPI API key.

Cuerpo

application/json

gen4.5
gen4_turbo

Request parameters for gen4.5.

model

enum<string>

requerido

Model ID for this request variant.

Opciones disponibles:

gen4.5

Allowed value: "gen4.5"

promptText

string

requerido

Describe the requested scene or motion in 1 to 1,000 UTF-16 code units.

Required string length: 1 - 1000

promptImage

requerido

Image to use as the first frame. Supply a media URI or a one-item array with position set to first.

Maximum string length: 2048

Pattern: ^https://

ratio

enum<string>

requerido

Requested output dimensions, expressed as width:height. Choose a value listed for this model and endpoint.

Opciones disponibles:

1280:720,

720:1280,

1104:832,

960:960,

832:1104,

1584:672

duration

integer

requerido

Requested video duration in whole seconds, from 2 through 10.

Rango requerido: 2 <= x <= 10

seed

integer

Optional sampling seed. Use a positive integer for an explicit seed. Omission or 0 selects a random seed.

Rango requerido: 0 <= x <= 4294967295

contentModeration

object

Optional content moderation settings. Omit the object to use standard moderation.

Show child attributes

outputFormat

enum<string>

Output encoding. Omit for mp4 (H.264). prores returns MOV; png_sequence returns a PNG ZIP; sdr_rec709_10bit returns 10-bit Rec.709 HEVC. hdr10 and hlg return 10-bit HDR MP4; hdr_pq_12bit_master returns 12-bit HEVC MOV; hdr_prores returns HDR ProRes MOV. The HDR PNG/EXR sequence formats return ZIP archives; the ACEScg variants target the named ACES version.

Opciones disponibles:

mp4,

prores,

png_sequence,

hdr10,

hlg,

sdr_rec709_10bit,

hdr_pq_12bit_master,

hdr_prores,

hdr_png_sequence,

hdr_exr_sequence,

hdr_exr_acescg_sequence_1_3,

hdr_exr_acescg_sequence_2_0

proresProfile

enum<string>

Profile for outputFormat prores or hdr_prores. Omit for 4444 with prores, or 422 HQ with hdr_prores. hdr_prores accepts only 422, 422 HQ, or 4444. Omit this field for other formats.

Opciones disponibles:

422,

4444,

422 Proxy,

422 LT,

422 HQ,

4444 XQ

Respuesta

Task submitted. Save its id to retrieve task status.

string

requerido

Task ID for GET /runwayml/v1/tasks/{id}.

status

string

Task state, when returned.

createdAt

string<date-time>

Task submission timestamp, when returned.

output

string<uri>[]

Result URLs, when returned.

failure

string

Failure explanation, when returned.

failureCode

string

Machine-readable failure code, when returned.

estimatedCost

object

Task estimate metadata, when returned.

Show child attributes

cost

object

Task cost metadata, when returned.

Show child attributes

Última modificación el 18 de septiembre de 2026

curl "https://api.cometapi.com/runwayml/v1/image_to_video" \
  --request POST \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "gen4.5",
  "promptImage": "https://upload.wikimedia.org/wikipedia/commons/3/3a/Cat03.jpg",
  "promptText": "The cat turns toward the camera.",
  "ratio": "1280:720",
  "duration": 5
}'

{
  "id": "00000000-0000-4000-8000-000000000001"
}

{
  "code": "<string>",
  "message": "<string>",
  "data": "<unknown>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Moderación de contenido

Claves API

Crea una tarea de imagen a vídeo de Runway

Elige un modelo

Proporciona el primer fotograma

Establece la duración y las dimensiones

Elige un formato de salida

Recupera el resultado

Autorizaciones

Cuerpo

Respuesta

​Elige un modelo

​Proporciona el primer fotograma

​Establece la duración y las dimensiones

​Elige un formato de salida

​Recupera el resultado

Autorizaciones

Cuerpo

Respuesta

Elige un modelo

Proporciona el primer fotograma

Establece la duración y las dimensiones

Elige un formato de salida

Recupera el resultado