Google

Veo 3.1

veo-3.1/text-to-video

Modelo de generación de vídeo de Google: la entrada de imagen permite generar de forma nativa vídeos de 8 segundos con sonido ambiental y diálogos, con soporte de hasta 4K y manteniendo la apariencia coherente del sujeto

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

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

Especificaciones	720P	1080P	4K
Sound On	$0.570	$0.570	$0.860
Sound Off	$0.290	$0.290	$0.570

Descripción general

La ruta de texto a vídeo de Veo 3.1 está dirigida a desarrolladores que necesitan producir un clip final directamente a partir de una sola frase de texto. Genera bajo demanda vídeos de 4 a 8 segundos, en 720p hasta 4K, en formato horizontal o vertical, con pista de audio nativa opcional, de modo que el sonido ambiente, los diálogos y los efectos de sonido descritos en el prompt se generan sincronizados con la imagen. Se invoca pasando el prompt a través de la interfaz unificada de HiAPI.ai, y resulta adecuada para anuncios cortos, contenido vertical para redes sociales y previsualización de storyboards, entre otros escenarios que requieren validar rápidamente una idea visual.

Aspectos clave

Sincronización nativa de audio e imagen, sin necesidad de doblaje aparte: al activar la generación de audio, el vídeo incluye sonido ambiente, diálogos y efectos de sonido, lo que reduce las etapas de diseño y síntesis de audio en posproducción.
Salida de hasta 4K por generación: resolution admite 720p, 1080p y 4k, y cubre desde la previsualización rápida hasta la entrega en alta calidad.
Cambio entre formatos horizontal y vertical según necesidad: aspect_ratio admite 16:9 y 9:16, y un mismo prompt puede producir directamente versiones adaptadas a feeds o a plataformas verticales.
Salida controlable con seed y prompt negativo: mediante seed se reproduce el resultado generado y con negative_prompt se excluyen los elementos no deseados, lo que facilita mantener un estilo fijo en la producción por lotes.

Capacidades

Vídeo corto directamente desde texto: basta con introducir un prompt descriptivo (hasta 20000 caracteres) para obtener directamente un clip de 4, 6 u 8 segundos, sin necesidad de preparar ningún material.

Generación de pista de audio nativa: permite generar audio nativo de forma opcional; al describir en el prompt el sonido ambiente, los diálogos o los efectos de sonido, el vídeo final incluye el sonido sincronizado y se evita el proceso de doblaje por separado.

Control de resolución y formato: la resolución de salida abarca 720p, 1080p y 4k, y el formato admite 16:9 y 9:16, para elegir según el canal de difusión.

Reproducibilidad y restricciones negativas: con un seed fijo se puede repetir el mismo resultado, y negative_prompt sirve para excluir elementos visuales no deseados, lo que facilita mantener la coherencia en la producción por lotes.

Casos de uso

Equipos de marketing que producen anuncios cortos con rapidez: generar con un prompt de argumentos de venta del producto un clip de 8 segundos con sonido, listo para la validación rápida de materiales de difusión y el montaje de una primera versión.
Gestión de redes sociales que crea vídeos verticales cortos: generar vídeos cortos en formato 9:16 para publicarlos en feeds o plataformas de vídeo corto, sin necesidad de recortar desde horizontal.
Previsualización de storyboards en la fase previa de cine y televisión: convertir la descripción del storyboard en clips dinámicos con efectos de sonido para la visualización de conceptos y la comunicación del equipo, lo que reduce el coste de prueba y error antes del rodaje real.
Pipelines de producción de contenido programática: los desarrolladores envían prompts por lotes a través de la interfaz unificada e integran los clips generados en su propio sistema de gestión de contenido o flujo de trabajo automatizado.

Limitaciones y recomendaciones de selección

La duración máxima por generación es de 8 segundos; para contenido más largo es necesario generar varias veces y unir los fragmentos. Activar el audio o aumentar la resolución eleva el coste por invocación, por lo que se recomienda elegir las especificaciones según los requisitos de difusión. Esta ruta es de texto a vídeo y no permite subir imágenes de referencia para mantener la apariencia de personas o productos; para esa necesidad conviene usar la ruta de imagen a vídeo de la misma familia. Si se requiere coherencia entre varios planos y una narración larga, sigue siendo necesario un trabajo adicional de organización manual y gestión de la coherencia.

Preguntas frecuentes

Ver todas las preguntas →

¿Qué tipo de modelo de video es Veo 3.1 Text to Video?

Es una vía de texto a video pura, solo requiere un Prompt de texto, no exige subir una imagen inicial.
¿Qué especificaciones de salida admite Veo 3.1 Text to Video?

Admite de 4 a 8 segundos, con resoluciones que incluyen 720p, 1080p y 4k, y relaciones de aspecto que incluyen 16:9 y 9:16.
¿Se puede generar voz o usar una referencia de audio?

La generación de audio está activada por defecto
¿Cómo se factura Veo 3.1 Text to Video?

Se factura según la duración de salida y el nivel en tiempo real; las diferencias debidas a la resolución, el modo o las opciones de audio se rigen por el precio de la página y el registro de la tarea.

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

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

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

seedintegerOpcional

Semilla aleatoria para resultados de generación reproducibles; valor entero. La misma semilla con la misma entrada reproduce la misma salida; si no se proporciona, el sistema la genera aleatoriamente.

promptstringObligatoriominLength 1maxLength 20000

Indicación de texto que describe el contenido del video que se desea generar; valor de cadena.

durationintegerObligatorioPredeterminado: 8min 4max 8

Duración del fragmento de video en segundos; el costo aumenta con la duración. Valor predeterminado: 8 segundos.

Opciones:468

resolutionstringObligatorioPredeterminado: "720p"

Resolución del video de salida; a mayor resolución, mayor costo. Valor predeterminado: 720p.

Opciones:720p1080p4k

aspect_ratiostringOpcionalPredeterminado: "16:9"

Relación de aspecto del video de salida. Valor predeterminado: 16:9.

Opciones:16:99:16

generate_audiobooleanOpcionalPredeterminado: true

Si se genera una pista de audio nativa para el video; al activarlo, el precio es mayor. Valor predeterminado: true.

negative_promptstringOpcional

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

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/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/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/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"
    }
  }
}