Introducción
HunyuanVideo 1.5 Text to video convierte un prompt escrito en un clip breve. HunyuanVideo 1.5 es el modelo de video abierto de Tencent, con 8.3 mil millones de parámetros; este endpoint devuelve 5 u 8 segundos en 480p o 720p, horizontal o vertical, con un prompt negativo para los artefactos. La plataforma no añade ningún filtro de contenido al prompt ni al clip.
Elige un modo según tu material de partida
| Lo que tienes | Modo |
|---|---|
| una descripción escrita | HunyuanVideo 1.5 Texto a video |
| una foto para animar | HunyuanVideo 1.5 Imagen a video |
Funciones y aspectos destacados
Personas naturales en un modelo pequeño
El modelo tiene 8.3 mil millones de parámetros y, aun así, en nuestras pruebas los rostros, la piel, el cabello y las telas se veían fotográficos y se movían sin deformarse.
Cuatro tamaños de cuadro
aspect_ratio y resolution se combinan en 832 x 480, 480 x 832, 1280 x 720 o 720 x 1280, de modo que los clips verticales se componen para la pantalla en lugar de recortarse.
Prompt negativo
Enumera lo que nunca quieres ver. Es la forma más rápida de corregir texto suelto, manos deformadas o desenfoque.
Sin censura
Sin filtro sobre el prompt ni el resultado. En nuestras pruebas la mayoría de los casos de contenido se reprodujeron como estaban escritos; el más fuerte retuvo parte de la escena.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Describe quién aparece en cuadro, qué viste y qué hace, y qué hace la cámara. Una acción clara por clip funciona mejor. mínimo 1 caracteres |
negative_prompt | No | Lista opcional de lo que debe quedar fuera, como "blurry, distorted hands, extra limbs, text, watermark". No cambia el precio. |
aspect_ratio | No | 16:9 para horizontal (el valor por defecto) o 9:16 para vertical. El formato no cambia el precio. |
resolution | No | 480p (832 x 480) o 720p (1280 x 720, el valor por defecto). 720p cuesta el doble por segundo; haz los borradores en 480p. |
duration_seconds | No | 5 u 8 segundos, cobrados por segundo. |
seed | No | Mantiene las ejecuciones comparables mientras cambias una sola cosa a la vez. No promete un clip idéntico fotograma a fotograma. |
Precios
Se cobra por segundo de salida según la resolución elegida. La relación de aspecto no cambia el precio.
| Especificación | Precio |
|---|---|
| $0.024 / segundo |
| $0.048 / segundo |
Casos de uso
Clips sociales verticales
9:16 a 720 x 1280 para feeds e historias.
Exploración de prompts
En 480p un borrador de cinco segundos es barato, así que puedes probar muchos prompts antes de escalar la idea.
Clips sin filtro para tu plataforma
Sin filtro de contenido sobre el prompt ni el clip, con solo adultos en pantalla.
Guía de prompts y consejos prácticos
Escribe la toma
Sujeto, vestuario, acción, luz, cámara: en ese orden, en dos a cuatro frases.
Una acción por clip
Cinco segundos dan para un gesto o un movimiento. Las cadenas de acciones se mezclan entre sí.
Mantén simples las escenas de contacto
Dos personas que se tocan tienden a enredar las extremidades; el movimiento lento y un plano más abierto ayudan.
Haz el borrador en pequeño
Prueba la idea en 480p con un seed fijo y luego repite la ganadora en 720p.
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": "tencent/hunyuan-video-1.5/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"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.
