Introducción
HunyuanVideo 1.5 Image to video anima una foto en un clip de 5 u 8 segundos en 480p o 720p. HunyuanVideo 1.5 es el modelo de video abierto de Tencent, con 8.3 mil millones de parámetros. El clip conserva la forma de tu foto, el prompt es opcional y la plataforma no añade ningún filtro de contenido.
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
Rostros que sobreviven al movimiento
En nuestras pruebas, las personas de la foto conservaron su rostro, su cabello y su vestuario a lo largo del clip.
Cualquier forma
No hay campo de relación de aspecto: las fotos verticales, cuadradas o panorámicas vuelven con su propia forma.
Prompt opcional
Envía solo la foto y el modelo decide el movimiento, o describe tú mismo el momento siguiente.
Sin censura
Sin filtro sobre la foto, el prompt ni el clip. 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 | No | Opcional. Describe lo que hace la persona a continuación y lo que hace la cámara; omítelo para que el modelo anime la foto por su cuenta. mínimo 1 caracteres |
image_url | Sí | El cuadro inicial. El clip parte de esta foto y conserva su relación de aspecto; debe ser un enlace público y descargable directamente. |
resolution | No | 480p o 720p (el valor por defecto). 720p cuesta el doble por segundo; la forma sigue a tu foto. |
duration_seconds | No | 5 u 8 segundos, cobrados por segundo. |
seed | No | Mantiene las ejecuciones comparables mientras cambias el prompt. No promete un clip idéntico fotograma a fotograma. |
Precios
Se cobra por segundo de salida según la resolución elegida. La forma de tu foto no cambia el precio.
| Especificación | Precio |
|---|---|
| $0.024 / segundo |
| $0.048 / segundo |
Casos de uso
Retratos con vida
Un retrato que sonríe, canta o se gira hacia la cámara.
Fotos de producto y de moda
Agrega movimiento de tela, una deriva de cámara o un giro a una foto de catálogo.
Animar las imágenes de tus usuarios sin filtro
Anima las propias imágenes de tus usuarios sin filtro de contenido, solo con adultos.
Guía de prompts y consejos prácticos
Describe el momento siguiente
Escribe lo que la persona hace después de tomada la foto, no lo que la foto muestra.
Di qué debe permanecer
Si una prenda o un objeto no debe cambiar, dilo en el prompt.
Una persona es más fácil que dos
Dos personas en contacto tienden a enredarse; mantén su movimiento lento.
Usa un enlace limpio y público
La imagen debe poder descargarse directamente; un enlace que exige iniciar sesión falla y no se cobra.
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/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p"
}
}'
# 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.
