Saltar al contenido principal
POST
/
runwayml
/
v1
/
image_to_video
Create a Runway image-to-video task
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"
}
'
{
  "id": "d0658ae1-bbdd-4adc-aaba-fd8070e14d79"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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
  • Empieza con duration: 5 y una proporción común como 1280:720

​
Flujo de la tarea

1

Enviar la solicitud de image-to-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 adelante.
3

Consultar el estado de la tarea

Usa Obtener detalles de la tarea. 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 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