Introducción
La API de texto a video de MiniMax H3 Lite genera clips con sonido de 4 a 15 segundos en 480p o 768p. Escribe la escena una vez y vuelve a lanzarla cambiando un solo detalle cada vez para ver qué toma funciona. Su diseño ligero sirve para probar ideas y producir varias versiones. Cada solicitud genera un solo MP4 en el que imagen y sonido salen juntos.
Qué modo abrir según tu punto de partida
| Lo que tienes | Modo |
|---|---|
| solo una idea | MiniMax H3 Lite Texto a video |
| un fotograma para animar, con un fotograma final opcional | MiniMax H3 Lite Imagen a video |
| personas, vestuarios, lugares, clips de movimiento o voces | MiniMax H3 Lite Referencia a video |
Funciones y aspectos destacados
Sonido y diálogo en una sola pasada
Cada clip de MiniMax H3 Lite llega con sonido. Pon las frases entre comillas dobles y describe la música o el ambiente con palabras; ambos llegan con el clip, así que un borrador rápido no requiere un paso de audio aparte.
Seis relaciones de aspecto
Las seis proporciones cuestan lo mismo, así que una idea puede probarse en corte horizontal y en corte vertical sin diferencia de precio.
Dos precios
480p cuesta alrededor de un 40% menos por segundo que 768p, así que es la forma barata de probar un prompt antes de renderizar la toma final.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Obligatorio, hasta 7,000 caracteres; uno más largo se rechaza. Pon los diálogos entre comillas dobles. mínimo 1 caracteres · máximo 7000 caracteres |
aspect_ratio | No | Uno de 16:9 (el predeterminado), 9:16, 1:1, 4:3, 3:4 o 21:9. No cambia el precio. |
resolution | No |
|
duration_seconds | No | Número entero de segundos, entre 4 y 15, con 5 por defecto. Esta duración y la resolución determinan juntas la tarifa por segundo. |
Precios
Cada segundo de salida se cobra a la tarifa de la resolución que elijas, 480p o 768p. La tarifa vigente siempre aparece en la página del modelo.
| Especificación | Precio |
|---|---|
| $0.025 / segundo |
| $0.04 / segundo |
Casos de uso
Storyboards y clips para presentaciones
Convierte una lista de tomas escrita en vistas previas en movimiento aproximadas antes de comprometerte con una producción. Cada prompt en MiniMax H3 Lite devuelve un clip terminado con sonido, así que el público escucha la escena además de verla, y una idea floja se puede descartar antes de hacer algo caro.
Borradores de prompts en volumen
Guionistas y desarrolladores de apps pueden probar muchas versiones de una escena en MiniMax H3 Lite y quedarse con la que funciona, pagando solo por segundo de salida. Si cambias una sola cosa por intento, ya sea la cámara, el vestuario o una línea de diálogo, la tanda te muestra qué versión merece un render más nítido.
Clips verticales con una línea de diálogo
Una escena 9:16 de 5 a 8 segundos con una línea entre comillas y ambiente encaja directamente en formatos sociales con MiniMax H3 Lite, sin un paso de edición para el sonido. Si publicas seguido, deja un escenario fijo y varía solo la acción y la línea; así cada borrador de 4 segundos a 480p cuesta $0.10.
Guía de prompts y consejos prácticos
Escribe la escena en orden
Describe quién está, qué hace primero y después, dónde está la cámara, y termina con una línea Audio: para el sonido. Un orden claro se lee mejor que un montón de adjetivos, y nombrar la luz, hora dorada o neón por ejemplo, fija el ambiente de inmediato.
Mantén corto el diálogo
Una o dos líneas entre comillas encajan en un clip de 5 a 8 segundos; indica quién dice cada línea para que la persona correcta mueva los labios. Los discursos largos salen apurados o cortados, así que repártelos entre varios clips.
Borrador barato, acabado preciso
Itera a 480p y renderiza la versión final a 768p con el mismo prompt; la composición se mantiene muy fiel.
Cada segundo de salida se cobra a la tarifa de la resolución que elijas, 480p o 768p. La tarifa vigente siempre aparece en la página del modelo.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "minimax/h3-lite/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "768p",
"aspect_ratio": "16:9",
"duration_seconds": 5
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.
















