Google

Veo 3.1 Fast

veo-3.1-fast/text-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/text-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/text-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

La línea de texto a vídeo veo-3.1-fast está dirigida a desarrolladores que necesitan producir clips finalizados con rapidez: basta con introducir un prompt de texto para generar un fragmento de vídeo con audio nativo, con duraciones de 4 a 8 segundos, resoluciones de 720p a 4k y dos formatos de encuadre, horizontal y vertical, además de poder elegir si se genera la pista de audio. Es adecuada para la producción de piezas terminadas como anuncios de marketing, presentaciones de producto, informes de demostración y contenido para redes sociales, así como para equipos que necesitan integrar la generación de vídeo por lotes en sus propios flujos de trabajo.

Puntos clave

Generación conjunta de vídeo y audio nativo: permite producir la pista de audio nativa al mismo tiempo que las imágenes, lo que elimina el paso de doblaje y síntesis de efectos de sonido por separado.
Resolución y duración ajustables según necesidad: admite resoluciones de 720p, 1080p y 4k, y duraciones de 4, 6 y 8 segundos, con encuadre seleccionable en 16:9 o 9:16.
Flujo de trabajo orientado a la producción rápida: la principal diferencia de esta serie es la generación rápida, adecuada para contenido finalizado que requiere entregas en ciclos cortos.
Dimensiones de control del prompt completas: ofrece prompt positivo, prompt negativo y semilla aleatoria, lo que facilita controlar la orientación del contenido y reproducir resultados.

Descripción de capacidades

Texto a vídeo: basta con introducir un prompt de hasta 20000 caracteres para generar un fragmento de vídeo, ideal para producir piezas finalizadas directamente a partir de un texto.

Generación de audio nativo: la generación de la pista de audio nativa se puede activar o desactivar; una sola llamada devuelve imagen y sonido a la vez, lo que reduce las tareas de audio en posproducción.

Selección de resolución y encuadre: la salida admite resoluciones de 720p a 4k y ofrece 16:9 horizontal y 9:16 vertical, lo que facilita la adaptación a distintos espacios de difusión.

Control de duración: la longitud del fragmento se puede elegir entre 4 y 8 segundos y se factura según la duración de salida, lo que facilita dividir los planos según la estructura del guion.

Resultados controlables y reproducibles: admite el prompt negativo para excluir elementos no deseados y, junto con la semilla aleatoria, permite reproducir un mismo resultado de generación.

Casos de uso

Equipos de marketing que producen anuncios cortos: generar planos breves con pista de audio a partir de textos con argumentos de venta del producto, para usarlos en materiales publicitarios y espacios de anuncios en redes sociales.
Cabeceras de presentaciones e informes corporativos: introducir una descripción del tema de negocio para generar fragmentos horizontales que se integran como imagen de apertura en materiales de informes o comunicación comercial.
Materiales para cursos y formación: generar a partir del guion del instructor fragmentos explicativos con ambiente de narración, para montarlos directamente en vídeos de cursos.
Producción de contenido vertical para redes sociales: generar material de vídeo corto en formato 9:16 para actualizaciones diarias de cuentas de contenido por lotes.

Limitaciones y recomendaciones de selección

Esta línea solo admite texto a vídeo y no acepta imágenes de referencia como entrada; cuando se necesite vídeo a partir de imagen, debe elegirse la línea de imagen a vídeo de la misma serie. La duración del fragmento es de 4 a 8 segundos, por lo que no cubre planos largos ni piezas completas; el contenido largo debe generarse por planos y montarse después. Activar el audio nativo o aumentar la resolución y la duración incrementa el coste de cada llamada; antes de la producción por lotes conviene validar los resultados con la semilla aleatoria y el prompt negativo. Para proyectos que requieren simulación física de alta precisión o simulación de movimiento compleja, este modelo no está optimizado específicamente.

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/text-to-video

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

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

seedintegerOpcional

Semilla aleatoria para una generación reproducible, en número entero; con la misma semilla y la misma configuración del resto de parámetros se pueden reproducir resultados de generación similares.

promptstringObligatoriomaxLength 20000

Indicación de texto que describe el contenido del video que se desea generar, en formato de cadena.

durationintegerObligatorioPredeterminado: 8min 4max 8

Duración del fragmento de video generado (en segundos), en número entero, por defecto 8; el costo aumenta a medida que se incrementa la duración.

Opciones:468

resolutionstringObligatorioPredeterminado: "720p"

Resolución del video de salida, en formato de cadena, por defecto 720p; cuanto mayor sea la resolución, mayor será el costo.

Opciones:720p1080p4k

aspect_ratiostringOpcionalPredeterminado: "16:9"

Relación de aspecto del video de salida, en formato de cadena, por defecto 16:9.

Opciones:16:99:16

generate_audiobooleanOpcionalPredeterminado: true

Si se genera una pista de audio nativa, en valor booleano, por defecto true; al activarlo, la facturación es mayor.

negative_promptstringOpcional

Indicación negativa, que describe con texto el contenido que debe evitarse en el video generado.

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/text-to-video",
  "input": {
    "prompt": "…",
    "duration": 8,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "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/text-to-video",
    input: {
      "prompt": "…",
      "duration": 8,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "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/text-to-video",
        "input": {
          "prompt": "…",
          "duration": 8,
          "resolution": "720p",
          "aspect_ratio": "16:9",
          "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"
    }
  }
}