Google

Veo 3.1 Fast

veo-3.1-fast/image-to-video

Modelo de imagen a vídeo de la serie Veo 3.1 enfocado en la generación rápida de clips, con generación sincronizada de imagen y audio, ideal para la producción de contenidos finales como marketing, presentaciones y redes sociales

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

Probar veo-3.1-fast/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-fast/image-to-video per second

Especificaciones	720P	1080P	4K
Sound On	$0.250	$0.250	$0.600
Sound Off	$0.170	$0.170	$0.500

Descripción general

veo-3.1-fast/image-to-video es una ruta de generación de video a partir de imagen dentro de la familia Google Veo 3.1, que se invoca a través de la interfaz unificada de HiAPI.ai. Basta con introducir una imagen de referencia y un prompt que describa la escena para extender una imagen estática a un video final con audio nativo. La resolución de imagen es seleccionable entre 720p y 4k, con duraciones de 4, 6 u 8 segundos; el detalle de los retratos y la fidelidad al prompt son sus principales puntos de uso, y resulta adecuado para desarrolladores que necesitan producir rápidamente piezas finales sin querer dedicar esfuerzo aparte a la locución y los efectos de sonido, como videos cortos de marketing, demostraciones y material para redes sociales.

Características destacadas

Generación de imagen y audio en una sola pasada: el video y la pista de audio nativa se producen en la misma generación, lo que elimina el paso intermedio de aplicar herramientas independientes de locución y efectos de sonido.
Resolución y duración ajustables según la necesidad: la salida admite tres niveles de resolución (720p, 1080p y 4k) y duraciones de 4, 6 u 8 segundos, para elegir con flexibilidad según las especificaciones de la pieza final y el presupuesto de costes.
Punto de partida de la imagen fijado por la referencia: la imagen de entrada sirve como base del primer fotograma y el prompt solo se encarga de describir cómo se mueve, lo que facilita mantener estable la apariencia del sujeto en comparación con la generación puramente textual.

Descripción de capacidades

Extensión de video guiada por imagen: recibe una imagen de referencia en 16:9 o 9:16 y un prompt, y convierte la imagen estática en un fragmento en movimiento; otras proporciones se recortan para adaptarse, y la relación de aspecto también puede especificarse manualmente o seguir a la imagen de entrada.

Interruptor de audio nativo: mediante el parámetro generate_audio se decide si se genera una pista de audio junto con el video; está activado por defecto, y puede desactivarse directamente cuando se necesita solo la imagen para un posprocesamiento posterior.

Restricción mediante prompt negativo: se puede rellenar además negative_prompt para describir el contenido que se desea evitar, con el fin de suprimir elementos visuales no deseados.

Reproducibilidad mediante semilla: ofrece el campo seed; al fijar la semilla se pueden realizar generaciones repetibles con la misma entrada y el mismo prompt, lo que facilita la depuración y la comparación.

Casos de uso

Equipos de marketing: imagen de producto + descripción de argumentos de venta: convierten imágenes de productos o escenas en videos cortos con efectos de sonido, listos para usarse en anuncios de feed, publicaciones en redes sociales y la zona de cabecera de páginas de aterrizaje.
Creadores de contenido: imagen de persona o escena + texto narrativo: producen material de video corto con sensación de narración, para publicar en plataformas de video corto o para la producción masiva de contenido seriado.
Presentaciones corporativas: esquemas + texto explicativo: convierten imágenes estáticas de material de presentación en fragmentos dinámicos, que se insertan en diapositivas o en páginas de presentación del sitio web para reforzar la expresión.
Creadores de material didáctico: gráficos o imágenes de demostración + descripción explicativa: generan fragmentos de tipo explicativo como complemento visual en cursos o material de formación, lo que reduce los costes de rodaje y edición.

Limitaciones y recomendaciones de selección

La duración máxima de una sola generación es de 8 segundos; si se necesita una narración más larga, solo se puede generar por segmentos y luego unirlos, y cada segmento debe controlar por separado la continuidad visual. La imagen de referencia debe ser de 720p o superior y proporcionarse en 16:9 o 9:16; de lo contrario, se recortará. Tanto la duración como la resolución afectan a la facturación, y 4k junto con el audio activado pertenece a un nivel de coste más alto. Este tipo de fragmentos es más adecuado para contenido tipo pieza final que para simulaciones físicas o de movimiento de alta precisión; si la necesidad es una simulación física estricta o planos continuos de larga duración, conviene considerar otros modelos o soluciones.

Preguntas frecuentes

Ver todas las preguntas →

¿Veo 3.1 Fast Image to Video requiere subir una imagen?

Sí. Actualmente, veo-3.1-fast/image-to-video es una ruta de video a partir de imagen: la imagen de entrada define el sujeto y la composición inicial, mientras que el Prompt define la acción, el movimiento de cámara y los cambios del entorno.
¿Qué duraciones y resoluciones admite Veo 3.1 Fast Image to Video?

El contrato de solicitud actual de HiAPI admite 4s / 6s / 8s, y la resolución de salida es 720p, 1080p, 4k. Los valores disponibles están sujetos al panel de parámetros de la página y a la documentación de la API.
¿Cómo se factura Veo 3.1 Fast Image to Video?

Las tareas se facturan según la duración de salida y el nivel seleccionado. La página muestra el precio en tiempo real según la unidad monetaria global, y el cargo final se basa en el registro de la tarea completada correctamente.
¿Cómo mejorar la estabilidad del sujeto en la generación de video a partir de imágenes?

Utiliza una imagen de entrada con un sujeto claro, pocas oclusiones y una composición completa; en el Prompt, describe primero la acción principal y el plano, y luego enumera la apariencia, los materiales y la relación con el fondo que deben conservarse. Para la primera prueba, se recomienda utilizar una duración más corta.

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-fast/image-to-video

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

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

seedintegerOpcional

Semilla aleatoria para obtener resultados de generación reproducibles; su valor es un número entero y, si no se proporciona, el servidor la genera de forma aleatoria.

promptstringObligatoriominLength 1maxLength 20000

Indicación de texto que describe de qué manera se desea que la imagen de entrada cobre movimiento; es una cadena de texto.

durationintegerObligatorioPredeterminado: 8min 4max 8

Duración del video generado, en segundos; su valor es un número entero, por defecto 8; el costo aumenta a medida que se incrementa la duración.

Opciones:468

image_urlstringObligatorio

URL de la imagen de entrada que se va a animar; se recomienda una resolución de 720p o superior y una relación de aspecto de 16:9 o 9:16; otras relaciones de aspecto se recortan para adaptarse.

resolutionstringObligatorioPredeterminado: "720p"

Resolución del video de salida; su valor es una cadena de texto, por defecto 720p; cuanto mayor sea la resolución, mayor será el costo.

Opciones:720p1080p4k

aspect_ratiostringOpcionalPredeterminado: "auto"

Relación de aspecto del video de salida; su valor es una cadena de texto, por defecto auto, es decir, sigue la relación de aspecto de la imagen de entrada.

Opciones:auto16:99:16

generate_audiobooleanOpcionalPredeterminado: true

Indica si se genera una pista de audio nativa; su valor es booleano, por defecto true; al activarlo, el precio es mayor.

negative_promptstringOpcional

Indicación negativa que describe el contenido que debe evitarse en el video generado; su valor es una cadena de texto.

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-fast/image-to-video",
  "input": {
    "prompt": "…",
    "duration": 8,
    "image_url": "…",
    "resolution": "720p",
    "aspect_ratio": "auto",
    "generate_audio": true
  }
}'

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-fast/image-to-video",
    input: {
      "prompt": "…",
      "duration": 8,
      "image_url": "…",
      "resolution": "720p",
      "aspect_ratio": "auto",
      "generate_audio": true
    }
  }),
});
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-fast/image-to-video",
        "input": {
          "prompt": "…",
          "duration": 8,
          "image_url": "…",
          "resolution": "720p",
          "aspect_ratio": "auto",
          "generate_audio": True
        }
    },
)
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"
    }
  }
}