Descripción general
Referencia de la API
Guías de integración
Errores
Precios y facturación
Formato oficial
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 --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": "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-Versionobligatorio, por ejemplo2024-11-06 - Usa
model: gen3a_turbo - Proporciona un
promptImageHTTPS estable - Comienza con
duration: 5y una proporción común como1280:720
Flujo de la tarea
Enviar la solicitud de imagen a video
Crea la tarea con una imagen de origen y un Prompt corto de movimiento opcional.
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
Bearer token authentication. Use your CometAPI key.
Encabezados
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.
Runway image-to-video model ID. Choose a current model from the Models page.
Random seed for reproducible results. Range: 0–999999999.
Text prompt describing the desired motion or scene. Maximum 512 characters.
Whether to add a watermark to the output video.
Video duration in seconds. Accepted values: 5 or 10.
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.
⌘I
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": "3d957031-9a2a-45e2-9dc7-bc8513059c50"
}