Imagen a Video

El endpoint de Imagen a Video da vida a las imágenes estáticas generando una animación de video de alta calidad basada en una instrucción de texto.

Nombre del Modelo: image-to-video

Ciclo de Vida: experimental

Tiempo de Procesamiento: ~60s–180s

Formato de Salida: MP4

Métodos de Entrega: URL (mediante sondeo de estado)

Créditos: 6 a 12 por video (depende de la duración)

Solicitud

Genera un video enviando tu imagen y tu instrucción al endpoint universal /v1/run:

POSThttps://fititon.app/api/v1/run

Ejemplos de Solicitud

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "image-to-video",
           "inputs": {
             "imageUrl": "https://example.com/product.jpg",
             "prompt": "Camera pans slowly around the model as she walks forward",
             "duration": 6,
             "aspectRatio": "9:16"
           }
         }'

Respuesta

Debido a que la generación de video toma varios minutos, el endpoint /v1/run devuelve un estado 200 OK inmediatamente con un id de trabajo asíncrono. Debes consultar la API de Estado usando GET /v1/status/{id} para recuperar la URL final del MP4. Alternativamente, puedes configurar webhooks para recibir notificaciones automáticamente. Ten en cuenta que nuestro despachador de webhooks impone un tiempo de espera estricto de 15 segundos. Tu servidor debe reconocer el webhook con un código de estado 2xx dentro de los 15 segundos, o lo consideraremos fallido y lo reintentaremos más tarde.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": null
}

Parámetros de Solicitud

Parámetros Obligatorios

imageUrlRequiredstring

La imagen de entrada para animar. Puede ser una URL de acceso público o una cadena de imagen codificada en Base64.

Consejo Profesional: Las imágenes con cabello, tela o follaje visibles producen el movimiento más natural. Las fotos estáticas de productos o de tipo "flat-lay" no se animan bien; usa imágenes con una persona o una escena. Evita las imágenes muy recortadas para darle espacio a la IA para el movimiento.

Requisito de Formato Al enviar una cadena Base64, debe incluir el prefijo URI de datos estándar (por ejemplo, data:image/jpeg;base64,...).

Parámetros Opcionales

promptstring

Una descripción textual que guía la animación. Si se omite, la IA inferirá el movimiento natural del contexto de la imagen.

durationinteger

La duración del video generado en segundos. Valores admitidos: 4, 6, 8. Predeterminado: 6

aspectRatio'16:9' | '9:16'

La relación de aspecto del video de salida. Predeterminado: 9:16

generateAudioboolean

Si se debe generar audio contextual con IA para acompañar el video. Predeterminado: true

Errores en Tiempo de Ejecución

Los errores en tiempo de ejecución para esta función utilizan el conjunto compartido documentado en Manejo de Errores. Si ocurre un error durante el procesamiento, el status se actualizará a "error" y el campo error contendrá la razón específica del fallo.

Costo de Créditos

Para las solicitudes de la API de Desarrolladores, el costo depende completamente de la duration del video solicitado.

Fórmula: Costo = CréditosPorDuración

Duración	Créditos por Video
4s	6
6s (Predeterminado)	9
8s	12