Por ahora esta guía solo está en inglés. →
Parámetros de la petición
| Parámetro | Obligatorio | Descripción |
|---|---|---|
seed | No | Repite el mismo número para obtener un resultado reproducible. ≥ 0 · ≤ 2147483647 |
prompt | Sí | Describe the scene, the action and the camera. |
resolution | No | Tamaño de salida. Más grande es más nítido y cuesta más. 480p · 720p · Por defecto: 720p |
aspect_ratio | No | La forma del encuadre: horizontal, cuadrado o vertical. 16:9 · 9:16 · Por defecto: 16:9 |
negative_prompt | No | Lo que no quieres ver. |
duration_seconds | No | Cuánto dura el clip. Se cobra por segundo. 5 · 8 · Por defecto: 5 |
Precios
Los precios están en créditos, los mismos que usas en la web (1 crédito = 0,01 $). El importe se retiene cuando se acepta la tarea y se liquida al coste real cuando termina; las tareas fallidas se reembolsan.
| Opción | Créditos por segundo | ≈ USD |
|---|---|---|
| resolution 480p | 3,6 | 0,036 US$ |
| resolution 720p | 7,2 | 0,072 US$ |
Para saber la cifra exacta antes de ejecutar, envía el mismo cuerpo a POST /jobs/quote.
Inicio rápido de la API
Llama a la API de HunyuanVideo 1.5 en tres pasos
- Crea una clave de API. Inicia sesión en PopNow y crea una clave en la consola de la API. Las claves empiezan por sk-popnow- y usan los mismos créditos que el sitio web.
- Envía la solicitud. Haz POST /jobs/createTask con model tencent/hunyuan-video-1.5/text-to-video y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
- Obtén el resultado. Consulta GET /jobs/recordInfo con el ID de tarea, o pasa una callBackUrl y te enviamos el resultado ahí. Descarga los enlaces de salida cuando la tarea termine bien.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $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",
"aspect_ratio": "16:9",
"resolution": "720p",
"duration_seconds": 5
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Sustituye el prompt y los enlaces por los tuyos. La pestaña API tiene la referencia de la respuesta, el sondeo y el callback.
Preguntas sobre la API de HunyuanVideo 1.5
¿Cuánto cuesta la API de HunyuanVideo 1.5?
HunyuanVideo 1.5 cuesta desde 18 créditos (0,18 US$) por un clip de 5 segundos con Crear video, su tarea más barata. Precios por opción: 480p 3,6 créditos por segundo, 720p 7,2 créditos por segundo. Los créditos son los mismos que en la web (1 crédito = 0,01 $), las cuentas nuevas reciben 30 créditos gratis y las tareas fallidas se reembolsan.
¿Cuál es el nombre de modelo de HunyuanVideo 1.5 en la API?
Pon tencent/hunyuan-video-1.5/text-to-video para Crear video; tencent/hunyuan-video-1.5/image-to-video para Imagen a video en el campo model de POST /jobs/createTask.
¿Qué es HunyuanVideo 1.5?
Un modelo de video abierto del equipo Hunyuan de Tencent, lanzado en noviembre de 2025. Tencent lo describe como un transformer de difusión de 8.3 mil millones de parámetros con un VAE causal 3D y un esquema de atención que omite las partes redundantes del video, diseñado para funcionar en GPU de consumo.
¿Cuánto duran y qué tamaño tienen los clips?
5 u 8 segundos a 24 fotogramas por segundo, en 480p o 720p. Text-to-video entrega 832 x 480, 480 x 832, 1280 x 720 o 720 x 1280; image-to-video conserva la forma de tu foto.
¿Genera sonido?
No. Los clips son archivos MP4 mudos, sin pista de audio. Agrega el sonido en tu propia edición o elige un modelo que genere audio junto con la imagen.
¿Necesito un prompt para image-to-video?
No. Ahí el prompt es opcional: sin él, el modelo anima la foto por su cuenta. Si lo usas, describe el movimiento y la cámara, no la foto en sí.
¿Cuánto tarda un clip?
En nuestras pruebas, un clip de 5 segundos en 480p tardó entre uno y dos minutos y medio de tiempo de modelo, y uno de 5 segundos en 720p, entre dos minutos y medio y cuatro.
¿Qué límites tiene la API de HunyuanVideo 1.5?
Duración del clip: 5–8 s; Resoluciones: 480p · 720p; Relaciones de aspecto: 16:9 · 9:16. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.
¿Puedo probar HunyuanVideo 1.5 sin escribir código?
Sí. El Playground ejecuta HunyuanVideo 1.5 con tus créditos de PopNow, no necesita clave API y te muestra el código de cada generación.

