Documentación de API

Guía completa para integrar la generación de video de AUTOMATIC-VIDEO API v1.3 en tus aplicaciones

🎥 Generar video desde imagen

Este endpoint iniciará una nueva tarea para generar un video a partir de una imagen prompt.

POST /v1/image_to_video

🔐 Autenticación

Utiliza el header HTTP Authorization con el esquema Bearer junto con una clave API.

Authorization: Bearer {{ YOUR_API_KEY }}

📋 Headers Requeridos

X-Runway-Version Requerido

Tipo: string

Valor: Este campo debe establecerse con el valor exacto 2024-11-06

📤 Parámetros del Cuerpo de la Solicitud

promptImage

Tipo: string (URL)

Descripción: URL de la imagen base para generar el video

Ejemplo: "http://example.com"

seed

Tipo: integer

Descripción: Semilla para la generación reproducible

Ejemplo: 1294967295

model

Tipo: string

Descripción: Modelo a utilizar para la generación

Ejemplo: "gen4_turbo"

promptText

Tipo: string

Descripción: Texto descriptivo para guiar la generación del video

duration

Tipo: integer

Descripción: Duración del video en segundos

Ejemplo: 5

ratio

Tipo: string

Descripción: Relación de aspecto del video

Ejemplo: "1280:720"

📝 Ejemplo de Solicitud

curl -X POST https://api.dev.runwayml.com/v1/image_to_video \
  -d '{
    "promptImage": "http://example.com",
    "seed": 1294967295,
    "model": "gen4_turbo",
    "promptText": "string",
    "duration": 5,
    "ratio": "1280:720"
  }' \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {{ YOUR_API_KEY }}" \
  -H "X-Runway-Version: 2024-11-06"

✅ Respuesta Exitosa

200

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "status": "processing",
  "createdAt": "2024-11-06T10:30:00Z",
  "model": "gen4_turbo",
  "duration": 5,
  "ratio": "1280:720"
}

🔄 Estados de la Tarea

processing

La tarea está siendo procesada

completed

La tarea se ha completado exitosamente

failed

La tarea ha fallado

📊 Información Adicional

Esta API utiliza tecnología avanzada de inteligencia artificial para generar videos de alta calidad a partir de imágenes estáticas. El proceso puede tomar varios minutos dependiendo de la duración y calidad solicitada.

💡 Consejos de Uso

Utiliza imágenes de alta resolución para mejores resultados
Los prompts de texto descriptivos mejoran la calidad del video generado
El campo 'seed' permite reproducir resultados consistentes
Diferentes modelos ofrecen distintas características y velocidades

⚠️ Limitaciones

Duración máxima del video: 10 segundos
Formatos de imagen soportados: JPG, PNG, WebP
Tamaño máximo de imagen: 10MB
Rate limit: 10 solicitudes por minuto