Introducción
Imagen a video con MiniMax H3 HighSpeed parte de una imagen fija que ya tienes y la anima en un MP4 de 4 a 15 segundos en 768p, con sonido. La imagen fija el aspecto; el prompt solo tiene que decir qué se mueve.
Elige un modo según el material de partida
| Lo que tienes | Modo |
|---|---|
| solo una idea | MiniMax H3 HighSpeed Texto a video |
| un fotograma para animar, con un fotograma final opcional | MiniMax H3 HighSpeed Imagen a video |
| personas, vestuarios, lugares, clips de movimiento o voces | MiniMax H3 HighSpeed Referencia a video |
Funciones y aspectos destacados
El fotograma define el aspecto
Los rostros, la ropa, la luz y la composición vienen de tu fotograma inicial. El clip conserva su forma y no hay campo de relación de aspecto, así que recorta la imagen al formato que quieras, horizontal o vertical, antes de enviarla.
Fotograma final opcional
Añade last_image_url y el clip se detiene sobre esa segunda imagen, con lo que controlas el movimiento entre dos imágenes fijas. Ayuda cuando una toma debe enlazar limpiamente con la siguiente.
Sonido incluido
El movimiento llega con sonido acorde, como oleaje, pasos, una risa o una línea entre comillas, sin cargo extra. Una línea Audio: en el prompt orienta el estilo musical o el sonido ambiente de la sala.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Obligatorio. Acepta de 1 a 7,000 caracteres y rechaza lo que sea más largo. mínimo 1 caracteres · máximo 7000 caracteres |
image_url | Sí | Fotograma inicial obligatorio; el clip sigue su forma. Cada lado debe medir de 256 a 5,760 píxeles, con una relación ancho-alto entre 0.4 y 2.5. |
last_image_url | No | Fotograma final opcional sobre el que el clip se detiene. No suma nada al precio. |
resolution | No |
|
duration_seconds | No | Un número entero de 4 a 15 (5 por defecto); cada segundo se factura a la tarifa de 768p. Una solicitud de 4 segundos volvió como un clip de 3.75 segundos. |
Precios
Pagas cada segundo del clip terminado en 768p; la tarifa vigente está en la página del modelo.
| Especificación | Precio |
|---|---|
| $0.072 / segundo |
Casos de uso
Productos y moda que se mueven
Una foto de catálogo de una chaqueta, un bolso o unos zapatos puede abrir un clip corto en el que el artículo se lleva puesto, se gira o se recoge, con la iluminación de la sesión original.
Dar vida a un retrato
Un solo retrato se convierte en un clip corto con una sonrisa, un giro de cabeza o un paso hacia la cámara, lo que basta para dar vida a una foto de perfil o a una ficha de personaje.
Transiciones controladas
Con un fotograma inicial y uno final, el modelo rellena el movimiento entre ambos: tomas de antes y después, cambios de vestuario o un personaje que empieza en una pose y termina en otra.
Guía de prompts y consejos prácticos
Describe el momento siguiente, no la imagen
Usa el prompt para añadir una secuencia corta al fotograma: un producto que gira hacia su etiqueta, un retrato que levanta la mirada, la cámara que se acerca. Pon primero la acción, luego la cámara y después el sonido.
Usa fotogramas que cumplan los límites
Mantén cada lado entre 256 y 5,760 píxeles y la relación ancho-alto entre 0.4 y 2.5. La salida sigue la forma de tu fotograma en 768p, así que revisa rostros, etiquetas y bordes en el resultado antes de publicar.
Combina fotogramas que encajen
Da al fotograma inicial y al final el mismo encuadre y la misma relación de aspecto, y planea una sola transición que quepa en 4 a 15 segundos. Mira el último segundo para comprobar si la toma aterriza en el fotograma final.
Pagas cada segundo del clip terminado en 768p; la tarifa vigente está 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-highspeed/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": "768p"
}
}'
# 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.
