Google

Veo 3.1 Lite

veo-3.1-lite/image-to-video

Nivel de generación de vídeo de Google de bajo coste y alto rendimiento, con una velocidad equiparable a Veo 3.1 Fast, compatible con imagen a vídeo, múltiples relaciones de aspecto y duraciones

veo-3.1-lite/image-to-video veo-3.1-lite/text-to-video

Probar veo-3.1-lite/image-to-video

Entrada

Creaciones

Ver todas las creaciones

Salida

video

Rellena los parámetros y genera: los resultados aparecerán aquí.

Precios

veo-3.1-lite/image-to-video per second

Especificaciones	720P	1080P
Sound Off	$0.060	$0.100
Sound On	—	$0.140

Descripción general

veo-3.1-lite/image-to-video es un modelo de imagen a video de la serie Google Veo 3.1 Lite, invocable a través de la interfaz unificada de HiAPI.ai. Toma una imagen de entrada como punto de partida y, junto con el prompt, transforma una imagen estática en un clip de video con audio nativo; la salida admite 720p y 1080p, relaciones de aspecto 16:9 y 9:16, y duraciones de 4, 6 u 8 segundos. Es adecuado para desarrolladores que necesitan convertir por lotes material de imágenes existente en videos cortos, así como para equipos que integran capacidades de generación de video en productos sensibles al costo.

Puntos clave

Anclado en la imagen, punto de partida controlable: utiliza la imagen de entrada como condición de generación y, junto con el prompt que describe el movimiento, reduce la deriva visual que provoca la generación puramente textual.
Audio nativo generado junto con el video: genera audio nativo de forma predeterminada, por lo que se obtiene directamente un clip con sonido y se elimina el paso independiente de doblaje o síntesis de efectos de sonido.
Combinación flexible de relación de aspecto y duración: admite dos relaciones de aspecto, 16:9 y 9:16, dos niveles de resolución, 720p y 1080p, y duraciones seleccionables de 4, 6 u 8 segundos.
Proceso de generación ajustable y controlable: ofrece prompt negativo, semilla aleatoria y parámetros de tolerancia de seguridad, lo que facilita reproducir resultados y restringir el contenido de salida.

Descripción de capacidades

Generación de video impulsada por imagen: al proporcionar la URL de una imagen y un prompt que describa el movimiento, se genera el video correspondiente; se recomienda que la imagen de entrada tenga una resolución de 720p o superior y una relación de aspecto de 16:9 o 9:16.

Selección de resolución y relación de aspecto: la salida puede ser 720p o 1080p, y la relación de aspecto admite 16:9, 9:16 o inferencia automática a partir de la imagen, lo que cubre tanto contenido horizontal como videos cortos verticales.

Duración controlable: la duración de cada generación puede configurarse entre 4, 6 y 8 segundos, con 8 segundos por defecto; la facturación se realiza por segundos de salida, lo que facilita controlar el gasto según la longitud del clip.

Interruptor de audio: permite activar o desactivar la generación de audio nativo; cuando se necesita material silencioso para doblaje posterior, puede desactivarse directamente para reducir procesamiento innecesario.

Restricciones de salida y reproducibilidad: mediante el prompt negativo se excluye el contenido no deseado, con la tolerancia de seguridad se ajusta la intensidad de la moderación y con una semilla fija se reproduce el mismo resultado de generación.

Casos de uso

Equipos de comercio electrónico y publicidad: imágenes estáticas de productos convertidas en clips dinámicos: transforman imágenes de productos en clips de exhibición dinámica de unos segundos para páginas de detalles, anuncios en flujos de información y material para publicaciones en redes sociales.
Operaciones de contenido: producción masiva de videos cortos verticales: con relación de aspecto 9:16 y duraciones de 4 a 8 segundos, convierten material de imágenes en videos cortos para la actualización diaria de contenido en plataformas de video breve.
Equipos de producto: integración de la función de imagen a video: integran la capacidad de imagen a video dentro del producto, de modo que los usuarios solo tengan que subir una imagen para obtener un clip de video corto con audio.
Validación creativa: vista previa rápida de bocetos de storyboard: convierten rápidamente storyboards o imágenes conceptuales en vistas previas dinámicas para la revisión de propuestas y la confirmación de la dirección creativa, antes de decidir si se invierte en la producción posterior.

Limitaciones y recomendaciones de selección

La resolución máxima es 1080p y la duración máxima por generación es de 8 segundos, por lo que no es adecuado para videos largos ni para necesidades de piezas finales de mayor resolución; la entrada depende de una imagen de 720p o superior, y para partir de texto puro conviene usar la línea de texto a video de la misma serie. El resultado de la generación se ve afectado por el prompt y los parámetros de moderación, por lo que es necesario prever costos de reintentos y filtrado. Si se requiere mayor duración, mayor resolución o un control más fuerte de la coherencia visual, conviene evaluar modelos de video de gama superior.

Crear una tarea de generación

POST https://api.hiapi.ai/v1/tasks

Encabezados

AuthorizationstringObligatorio

Clave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API

Content-TypestringOpcional

El cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.

Idempotency-KeystringOpcional

Clave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.

Clave de idempotencia

Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.

Cuerpo

modelstringObligatorio

Valor fijo actual: veo-3.1-lite/image-to-video

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para veo-3.1-lite/image-to-video y la ruta default; consulta la tabla de parámetros a continuación.

seedintegerOpcional

Semilla aleatoria, valor entero, se utiliza para hacer reproducible el resultado de la generación; la misma semilla con los demás parámetros idénticos permite obtener la misma salida.

promptstringObligatoriominLength 1

Prompt de texto que describe cómo se desea animar la imagen de entrada, valor de tipo cadena.

auto_fixbooleanOpcionalPredeterminado: false

Indica si se reescriben automáticamente los prompts que no superan la validación, valor booleano, por defecto false.

durationintegerOpcionalPredeterminado: 8min 4max 8

Duración del fragmento de vídeo generado, en segundos, entero, por defecto 8.

Opciones:468

image_urlstringObligatorio

URL de la imagen de entrada que se va a animar, cadena; se recomienda usar una imagen con proporción 16:9 o 9:16 y una resolución no inferior a 720p.

resolutionstringOpcionalPredeterminado: "720p"

Resolución del vídeo de salida, cadena, por defecto 720p.

Opciones:720p1080p

aspect_ratiostringOpcionalPredeterminado: "auto"

Relación de aspecto del vídeo de salida, cadena, por defecto auto.

Opciones:auto16:99:16

generate_audiobooleanOpcionalPredeterminado: true

Indica si se genera audio nativo, valor booleano, por defecto true.

negative_promptstringOpcional

Prompt negativo que describe el contenido que debe evitarse en el vídeo generado, valor de tipo cadena.

safety_tolerancestringOpcionalPredeterminado: "4"

Nivel de tolerancia de la moderación de contenido, cadena, por defecto 4.

Opciones:123456

callbackobjectOpcional

Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.

Callbacks (Webhook)

Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.

urlstringObligatorio

Obligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.

whenstringOpcionalPredeterminado: "final"

Actualmente solo se admite final: notifica tanto en success como en fail.

Opciones:final

storagestringOpcionalPredeterminado: "temp"

Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.

Opciones:temppersistent

Ejemplos de solicitud

# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "veo-3.1-lite/image-to-video",
  "input": {
    "prompt": "…",
    "auto_fix": false,
    "duration": 8,
    "image_url": "…",
    "resolution": "720p",
    "aspect_ratio": "auto",
    "generate_audio": true,
    "safety_tolerance": "4"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "veo-3.1-lite/image-to-video",
    input: {
      "prompt": "…",
      "auto_fix": false,
      "duration": 8,
      "image_url": "…",
      "resolution": "720p",
      "aspect_ratio": "auto",
      "generate_audio": true,
      "safety_tolerance": "4"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "veo-3.1-lite/image-to-video",
        "input": {
          "prompt": "…",
          "auto_fix": False,
          "duration": 8,
          "image_url": "…",
          "resolution": "720p",
          "aspect_ratio": "auto",
          "generate_audio": True,
          "safety_tolerance": "4"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtener el detalle de la tarea

GET https://api.hiapi.ai/v1/tasks/:id

Campos de respuesta

taskIdstringObligatorio

ID de tarea, siempre con prefijo tk-hiapi-.

modelstringObligatorio

Nombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.

routestringOpcional

Solo aparece si se usó el parámetro route explícito; repite el valor enviado.

statusstringObligatorio

Estado de la tarea.

Valores de estado

queued En cola, sin iniciar. handling Procesando. archiving Proceso terminado, preparando artefactos. success Terminal: completado, artefactos disponibles (se devuelve output). fail Terminal: error (se devuelve error). Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.

creatednumberObligatorio

Hora de creación de la tarea (segundos Unix).

completednumberObligatorio

Segundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.

outputarrayOpcional

Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).

Array [ object ]

Elementos del array

urlstringObligatorio

URL del artefacto, descargable directamente.

typestringObligatorio

Valores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.

expireAtnumberObligatorio

Segundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.

errorobjectOpcional

Solo con status == fail.

codestringObligatorio

Código de error de negocio.

messagestringObligatorio

Descripción del error.

Ejemplos de respuesta

Éxito

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En proceso (no terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fallido

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}