Veo 3.1 Lite
veo-3.1-lite/text-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
Probar veo-3.1-lite/text-to-video
Entrada
Creaciones
Ver todas las creacionesSalida
videoPrecios
veo-3.1-lite/text-to-video per second
Descripción general
veo-3.1-lite/text-to-video es la línea de texto a vídeo de la familia Google Veo 3.1 Lite, orientada a desarrolladores que necesitan producir vídeos cortos por lotes. Basta con introducir un prompt en lenguaje natural para generar clips de vídeo con audio nativo, con soporte para 720p/1080p, relaciones de aspecto 16:9 y 9:16, duraciones de 4/6/8 segundos, y control del resultado mediante parámetros como seed y negative_prompt. Resulta adecuada para escenarios de ingeniería sensibles al coste y a la velocidad de iteración, como vídeos cortos de marketing, contenido para redes sociales y generación de vídeo dentro de productos, todo ello mediante la interfaz unificada de HiAPI.ai.
Aspectos destacados
- Generación de audio nativo: produce audio de forma sincronizada al generar la imagen, activado por defecto y desactivable según se necesite para flujos de montaje sin sonido.
- Cobertura de formatos horizontal y vertical: incluye las relaciones 16:9 y 9:16, de modo que una sola integración cubre la distribución de contenido tanto en horizontal como en vertical.
- Duración y resolución seleccionables: tres duraciones de 4, 6 y 8 segundos combinadas con resoluciones de 720p/1080p, lo que permite equilibrar la calidad del resultado final y el coste según el escenario.
- Parámetros de control completos: ofrece seed para reproducir resultados, negative_prompt para excluir contenido, auto_fix para corregir prompts y tolerancia de seguridad, entre otros ajustes.
Descripción de capacidades
Generación de vídeo a partir de prompts: describe una escena en lenguaje natural y genera el clip de vídeo correspondiente; es la forma de entrada básica para construir cadenas de producción de vídeo automatizadas.
Salida de audio nativo: el resultado generado incluye audio sincronizado, lo que elimina los pasos posteriores de doblaje y montaje de efectos de sonido; si se desactiva, se obtiene material sin sonido.
Salidas con múltiples especificaciones: combina los parámetros resolution, aspect_ratio y duration para obtener la especificación deseada; la salida puede pasar directamente al flujo de edición o de publicación.
Resultados controlables y reproducibles: un seed fijo permite reproducir el mismo resultado, negative_prompt evita los elementos no deseados y auto_fix reescribe automáticamente el prompt cuando falla la validación, reduciendo la tasa de fallos de las llamadas.
Casos de uso
- Producción por lotes de anuncios cortos para equipos de marketing: introduce el tema de la campaña y la descripción de los puntos de venta para generar por lotes clips de 8 segundos con audio, destinados a pruebas de creatividades publicitarias e iteraciones A/B rápidas.
- Vídeo vertical para creadores de contenido en redes sociales: genera clips cortos con relación 9:16 para actualizar directamente el contenido de plataformas de vídeo corto y muros sociales.
- Integración de capacidades de vídeo para desarrolladores de producto: llama de forma automatizada a la generación de vídeo mediante prompts dentro del producto y ofrécela a los usuarios finales como módulo funcional.
- Previsualización de guiones para equipos creativos: convierte rápidamente el texto del storyboard en clips de 4 segundos y, junto con un seed fijo para reproducir la propuesta, permite confirmar visualmente la fase de presentación.
Limitaciones y recomendaciones de selección
La duración máxima por generación es de 8 segundos y la resolución máxima es 1080p, por lo que no es adecuada para vídeos largos, narrativas continuas ni resultados finales de mayor definición; en proyectos complejos que requieran movimientos de cámara y transiciones precisas, se recomienda dividir la generación en varios fragmentos y editarlos después. El parámetro de tolerancia de seguridad limita la producción de contenido de determinadas temáticas. Si la tarea parte de una imagen, debe elegirse la línea de imagen a vídeo de la misma familia en lugar de esta.
Crear una tarea de generación
https://api.hiapi.ai/v1/tasks Encabezados
AuthorizationstringObligatorioClave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API
Content-TypestringOpcionalEl 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-KeystringOpcionalClave 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.
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
modelstringObligatorioValor fijo actual: veo-3.1-lite/text-to-video
routestringOpcionalValor fijo actual: default
inputobjectObligatorio
Objeto de parámetros de negocio para veo-3.1-lite/text-to-video y la ruta default; consulta la tabla de parámetros a continuación.
seedintegerOpcionalSemilla aleatoria para generar resultados reproducibles; al pasar la misma semilla y los mismos parámetros se obtiene una salida de vídeo consistente. Si no se proporciona, el servidor la decide de forma aleatoria.
promptstringObligatoriominLength 1Indicación de texto que describe el contenido del vídeo a generar; es la entrada principal para la generación de vídeo a partir de texto.
auto_fixbooleanOpcionalPredeterminado: trueIndica si se reescriben automáticamente las indicaciones que no superan la validación. Predeterminado: true.
durationintegerOpcionalPredeterminado: 8min 4max 8Duración del fragmento de vídeo generado, en segundos. Predeterminado: 8 segundos.
468resolutionstringOpcionalPredeterminado: "720p"Resolución del vídeo de salida. Predeterminado: 720p.
720p1080paspect_ratiostringOpcionalPredeterminado: "16:9"Relación de aspecto de la imagen del vídeo de salida. Predeterminado: 16:9.
16:99:16generate_audiobooleanOpcionalPredeterminado: trueIndica si se genera audio nativo local. Predeterminado: true.
negative_promptstringOpcionalIndicación negativa que especifica el contenido que debe evitarse en el vídeo generado.
safety_tolerancestringOpcionalPredeterminado: "4"Nivel de tolerancia de la moderación de contenido. Predeterminado: "4".
123456callbackobjectOpcional
Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.
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.
urlstringObligatorioObligatorio 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.
finalstoragestringOpcionalPredeterminado: "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.
temppersistentEjemplos 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/text-to-video",
"input": {
"prompt": "…",
"auto_fix": true,
"duration": 8,
"resolution": "720p",
"aspect_ratio": "16:9",
"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/text-to-video",
input: {
"prompt": "…",
"auto_fix": true,
"duration": 8,
"resolution": "720p",
"aspect_ratio": "16:9",
"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/text-to-video",
"input": {
"prompt": "…",
"auto_fix": True,
"duration": 8,
"resolution": "720p",
"aspect_ratio": "16:9",
"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
https://api.hiapi.ai/v1/tasks/:id Campos de respuesta
taskIdstringObligatorioID de tarea, siempre con prefijo tk-hiapi-.
modelstringObligatorioNombre 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.
routestringOpcionalSolo aparece si se usó el parámetro route explícito; repite el valor enviado.
statusstringObligatorioEstado de la tarea.
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.
creatednumberObligatorioHora de creación de la tarea (segundos Unix).
completednumberObligatorioSegundos 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
urlstringObligatorioURL del artefacto, descargable directamente.
typestringObligatorioValores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.
expireAtnumberObligatorioSegundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.
errorobjectOpcional
Solo con status == fail.
codestringObligatorioCódigo de error de negocio.
messagestringObligatorioDescripció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"
}
}
} Artículos
Ver todos los artículos →-
Tutorial
Tutorial de kandinsky-6.0-pro/image-to-video en HiAPI: curl + Python
Realiza una solicitud de imagen a video funcional en HiAPI: desde la carga del primer fotograma hasta el sondeo asíncrono y la descarga final
-
Tutorial
Cómo llamar a kling-4.0/image-to-video en HiAPI: curl, Python y sondeo
-
Comparativa
Recraft v4.1 Flash comparativa horizontal de texto a imagen: guía de selección y migración para desarrolladores
Con un coste de $0.01 por imagen y capacidad pura de texto a imagen, evalúa si encaja en tu pipeline de generación de imágenes
-
Tutorial
Uso de Kandinsky 6.0 Pro texto a video en HiAPI: tutorial con curl y Python
Demostración práctica centrada en la solicitud: construir la llamada de prompt a clip de video, enviar la solicitud, sondear el estado de finalización y descargar el resultado
-
Tutorial
Cómo llamar a hailuo-2.3/text-to-video mediante la API de HiAPI: curl, Python y ejemplos de solicitud ejecutables
-
Tutorial
Cómo usar kling-4.0/text-to-video a través de la API de HiAPI: curl, Python y un ejemplo de solicitud ejecutable
Guía práctica para desarrolladores: prompts cinematográficos, audio sincronizado, sondeo asíncrono y descarga de resultados
-
Tutorial
Cómo llamar a hailuo-2.3-fast/image-to-video a través de la API de HiAPI: práctica con curl y Python
La primera solicitud ejecutable del nivel rápido y de bajo coste de imagen a vídeo: del ID del modelo a la descarga del MP4
-
Comparativa
hailuo-2.3-fast/image-to-video comparativa horizontal: cómo elegir un modelo de imagen a video y puntos clave para migrar
Modelos relacionados
Ver todos los modelos →Mismo tipo
-
Gemini Omni Google -- -
Creatify Boreal Creatify $0.015 /segundo -
MiniMax H3 MiniMax $0.072 /segundo -
Kling 4.0 Kuaishou $0.330 /segundo -
Seedance 2.5 ByteDance $0.121 /segundo -
Grok Imagine 1.5 Lite xAI $0.029 /segundo -
Veo 3.1 Fast Google $0.170 /segundo -
HappyHorse 1.1 Alibaba $0.160 /segundo -
Kling AI Avatar Kuaishou -- -
PixVerse V6 PixVerse $0.036 /segundo -
Kling 3.0 Turbo Kuaishou $0.130 /segundo -
Wan 2.7 Video Alibaba $0.100 /segundo
Mismo proveedor
-
Gemini Omni Google -- -
Veo 3.1 Google $0.290 /segundo -
Nano Banana 2 Google $0.036 /imagen -
Nano Banana Pro Google $0.057 /imagen -
Lyria 3 Pro Google $0.140 /canción -
Nano Banana 2 Lite Google $0.033 /imagen -
Nano Banana Google $0.021 /imagen -
Google Virtual Try-On Google $0.107 /imagen -
Veo 3.1 Lite Google $0.060 /segundo -
Gemini Omni 1.1 Flash Google $0.450 /vídeo -
Veo 3.1 Fast Google $0.170 /segundo -
Gemini 3.1 Flash TTS Google --