Introducción
Extensión de video con MiniMax H3 Max. Envía el clip que quieres continuar y describe lo que sigue: el último fotograma de tu clip se convierte en el fotograma inicial de un nuevo plano de image-to-video de MiniMax H3 Max, y el original y el segmento nuevo vuelven unidos en un único MP4. Solo se cobran los segundos nuevos.
| Campo | Valor |
|---|---|
| Entrada | Video |
| Salida | Video |
| Publicado por | MiniMax |
| Endpoints | text-to-video, image-to-video, video-extend |
| Duración | De 5 a 15 segundos, en segundos enteros, 8 por defecto |
| Resolución | 480p, 768p (predeterminada) |
| Proporciones | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 (text-to-video; 1:1 por defecto) |
| Control de cuadros | Cuadro de apertura obligatorio en image-to-video, cuadro de cierre opcional |
| Audio | Generado junto con la imagen |
| Ejecución | Tarea asíncrona, cobrada por segundo de salida |
Funciones y aspectos destacados
Pensado para convertir un brief en video con rapidez
MiniMax presenta H3 Max como la variante de generación rápida de H3, optimizada para la velocidad. Aquí funciona en 480p o 768p con sonido en la misma pasada, lo que encaja con un ciclo de escribir, renderizar y ajustar. Los clips empiezan en cinco segundos, así que la solicitud más corta ya es un momento aprovechable y no un fotograma de prueba.
Dile dónde empieza el plano y dónde termina
El image-to-video toma un cuadro de apertura y, opcionalmente, uno de cierre. Los dos extremos quedan entonces fijos y solo se genera el movimiento intermedio, algo útil cuando un clip tiene que cortar limpio dentro de una edición. Los dos cuadros deben mantenerse continuos en sujeto, vestuario y luz, o el medio del clip negociará entre ellos a la vista.
Fija el encuadre antes de juzgar una toma
Text-to-video usa 1:1 por defecto, así que un brief panorámico vuelve cuadrado si aspect_ratio no dice otra cosa: fíjalo en 21:9, 16:9, 4:3, 3:4 o 9:16 antes de comparar tomas. Image-to-video no tiene campo aspect_ratio: el fotograma inicial decide la forma, así que recorta la imagen antes de enviarla.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
last_image_url | No | Fotograma final de destino opcional: el segmento nuevo termina sobre esta imagen. Solo guía el final; el tramo central sigue libre. |
prompt | Sí | Obligatorio. Lo que sucede después: la acción que sigue, el movimiento de cámara y el sonido. mínimo 1 caracteres · máximo 7000 caracteres |
duration_seconds | No | Duración del segmento nuevo: segundos enteros, de 5 a 15; por defecto 8. Tu origen se suma por delante y no se cobra. |
resolution | No | Resolución del segmento nuevo: 480p o 768p, por defecto 768p. Ambas son renders nativos. |
enable_prompt_expansion | No | Desactivado por defecto, así que el prompt se usa tal como lo escribes. Valor predeterminado: |
video_url | Sí | El clip que se va a continuar: MP4, MOV o WebM, de hasta 60 segundos. mínimo 1 caracteres |
Precios
Se cobra por segundo del segmento nuevo en la resolución que elijas; el clip de origen que envías no se cobra. Una generación fallida, o una unión que no se pueda construir, se reembolsa por completo. Activar la ampliación del prompt añade una tarifa fija por solicitud.
| Especificación | Precio |
|---|---|
| $0.05 / segundo |
| $0.08 / segundo |
Casos de uso
Planos protagonistas desde un cuadro aprobado
Cuando la escena está cerrada, genera primero el fotograma inicial y envíalo a image-to-video: el vestuario, el cuerpo y el rostro que diseñaste se mantienen en lugar de reinventarse en cada ejecución.
Video de campaña anamórfico
21:9 con una caminata lenta hacia cámara, luz de contorno dura y una máquina de viento: la gramática de cine de moda que este nivel hace bien. Una solicitud de 15 segundos cubre el momento completo de acercarse y detenerse, así que no hay costura que disimular en la edición.
Versiones verticales del mismo brief
El mismo plano escrito vuelve a ejecutarse en 9:16 para feeds y en 1:1 para ubicaciones cuadradas. Mantén el prompt y la duración y cambia solo la relación de aspecto para ver cómo funciona el reencuadre antes de producir todo el set de entregables.
Clips que tienen que encajar en el montaje
Cuando un plano tiene que empezar en una viñeta y terminar en otra, entrega las dos como image_url y last_image_url. El movimiento generado aterriza en la composición de cierre, así que el cuadro de salida coincide con el plano siguiente de la línea de tiempo.
Guía de prompts y consejos prácticos
Elige entre texto y primer cuadro
Una idea escrita va a text-to-video; una imagen fija aprobada va a image-to-video, que la sigue mucho más al pie de la letra. Los dos endpoints no comparten conjunto de campos: image-to-video no tiene
aspect_ratio, porque el cuadro de apertura decide la forma.Escribe el plano y después fija el cuadro
Describe sujeto, movimiento, luz y sonido en el orden en que ocurren, y fija
aspect_ratiotú mismo porque el valor por defecto es 1:1. Un brief que funciona se ve así, en inglés tal como se envió: “High-fashion campaign film. An adult model in a liquid-silver slip gown walks slowly toward camera down a black marble corridor, the fabric catching hard rim light and rippling with each step, hair moving in a wind machine, she stops and looks straight down the lens. Anamorphic 2.39:1, deep blacks, glossy specular highlights, low synth drone.”Itera con un cambio a la vez
Cambia una sola cosa por ejecución para que cada resultado refleje solo lo que editaste, y escribe en el prompt los detalles que te importan en lugar de dejar huecos para que los rellene el modelo. El sonido se genera con la imagen, así que cualquier indicación de música o ambiente va en el mismo prompt.
Introducción
MiniMax H3 Max Extensión de video continúa un clip que ya tienes. Envíalo como video_url con un prompt de lo que sucede después. El último fotograma de tu clip pasa a ser el fotograma inicial de un nuevo plano de image-to-video de MiniMax H3 Max de 5 a 15 segundos, y ambos se unen en un solo MP4: primero tu original, luego la continuación, sin el fotograma repetido de la costura. El segmento nuevo también vuelve como archivo propio, de modo que puedes seguir extendiendo o editar las piezas por separado.
Características clave y puntos destacados
La continuidad viene del último fotograma
El vestuario, el decorado, la luz y la posición de cada persona se mantienen porque el segmento nuevo empieza literalmente en tu último fotograma. El movimiento no se hereda del mismo modo: el modelo ve una imagen fija, no el clip entero, así que describe el movimiento que quieres continuar en lugar de suponer que mantendrá su velocidad o su dirección.
Un archivo de vuelta, más la pieza nueva por separado
El MP4 unido conserva la tasa de fotogramas y el encuadre de tu clip, sin bandas negras. Para que la costura quede alineada, la imagen puede recortarse o ajustarse unos pocos puntos porcentuales en los bordes. Si el modelo devuelve una proporción claramente distinta, el segmento nuevo se escala hasta llenar tu encuadre, se centra y se recorta lo que sobresale. El segmento nuevo trae sonido generado en la misma pasada; el sonido de tu origen se conserva y la costura se funde durante una fracción de segundo. Si un lado es mudo, el otro se rellena con silencio. El segundo recurso de la salida es el segmento nuevo solo, con el rol segment, listo para otra extensión o para un editor.
Un fotograma final opcional
last_image_url es opcional. Envía una imagen y el segmento nuevo termina sobre ella; si la omites, el final es libre. El fotograma final solo ajusta el desenlace, y cuanto más largo es el segmento, más puede alejarse de él el tramo central.
Todo lo demás es image-to-video de MiniMax H3 Max
El segmento nuevo se ejecuta por las mismas rutas, con el mismo rango de contenido y el mismo precio por segundo que el endpoint de image-to-video, y una generación fallida se reembolsa igual. Si la generación termina bien pero no se puede construir la unión, la tarea falla y se reembolsa el cargo.
Casos de uso
Alargar un plano que terminó demasiado pronto
Una plataforma giratoria de producto que se detiene antes de que la etiqueta mire a cámara, o un paseo que corta antes de que el sujeto llegue a la puerta. Extiéndelo unos segundos y describe solo el movimiento que falta.
Construir una secuencia más larga paso a paso
Una solicitud produce como máximo 15 segundos. Para ir más lejos, genera un primer plano, extiéndelo y luego extiende de nuevo el resultado unido; cada paso cobra solo los segundos que añade. Como cada paso parte de un único fotograma, revisa cada costura antes de apilar la siguiente.
Guía de prompts y consejos profesionales
Describe el siguiente tiempo, no toda la escena
El fotograma ya fija quién y dónde, así que dedica el prompt a la acción que sigue, el movimiento de cámara y el sonido. Repite el lenguaje de cámara con el que terminó tu clip, como un avance lento o un plano fijo, para que la costura se lea como una sola toma.
Recorta antes de extender
El último fotograma es lo único que ve el modelo, así que un final borroso, cortado a mitad de movimiento o muy comprimido pasa directo a la continuación. Corta primero tu origen en un fotograma limpio y nítido. Se aceptan orígenes de hasta 60 segundos en MP4, MOV o WebM.
Mantén la resolución coherente
La resolución solo define la nitidez con la que se genera el nuevo segmento, así que un ajuste menor hace que la parte nueva se vea más suave que el original. Iguala la resolución de tu original y ajusta duration_seconds a la duración que de verdad necesitas: el cobro sigue solo al nuevo segmento.
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-max/video-extend",
"input": {
"duration_seconds": 8,
"enable_prompt_expansion": false,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "768p",
"video_url": "https://example.com/reference.mp4"
}
}'
# 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.
