Introdução
Extensão de vídeo com o MiniMax H3 Max. Envie o clipe que você quer continuar e descreva o que acontece depois: o último quadro do clipe vira o quadro inicial de um novo plano de image-to-video do MiniMax H3 Max, e o original e o novo segmento voltam unidos em um único MP4. Só os segundos novos são cobrados.
| Campo | Valor |
|---|---|
| Entrada | Vídeo |
| Saída | Vídeo |
| Fabricante | MiniMax |
| Endpoints | text-to-video, image-to-video, video-extend |
| Duração | 5 a 15 segundos, só segundos inteiros, padrão 8 |
| Resolução | 480p, 768p (padrão) |
| Proporções | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 (text-to-video; padrão 1:1) |
| Controle de quadro | Quadro de abertura obrigatório no image-to-video, fechamento opcional |
| Áudio | Gerado junto com a imagem |
| Execução | Tarefa assíncrona, cobrada por segundo de saída |
Recursos e destaques
Feito para transformar um brief rapidamente
A MiniMax apresenta o H3 Max como a variante de geração rápida do H3, otimizada para velocidade. Aqui ele roda em 480p ou 768p com som na mesma passada, o que combina com um ciclo de escrever, renderizar e ajustar. Os clipes começam em cinco segundos, então a requisição mais curta já é um momento aproveitável, não um frame de teste.
Diga onde o plano começa e onde ele para
O image-to-video aceita um quadro de abertura e, opcionalmente, um de fechamento. As duas pontas ficam fixas e só o movimento entre elas é gerado — útil quando um clipe precisa entrar limpo numa edição. Os dois quadros têm de ficar contínuos em sujeito, figurino e luz, ou o miolo do clipe negocia entre eles de forma visível.
Defina o quadro antes de julgar uma tomada
Text-to-video usa 1:1 por padrão, então um brief widescreen volta quadrado se aspect_ratio não disser outra coisa: defina 21:9, 16:9, 4:3, 3:4 ou 9:16 antes de comparar tomadas. Image-to-video não tem campo aspect_ratio: o frame inicial decide o formato, então recorte a imagem antes de enviar.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
last_image_url | Não | Quadro final de destino opcional: o novo segmento termina nessa imagem. Ele só orienta o final; o meio continua livre. |
prompt | Sim | Obrigatório. O que acontece depois: a ação que segue, o movimento de câmera e o som. pelo menos 1 caracteres · no máximo 7000 caracteres |
duration_seconds | Não | Duração do novo segmento: segundos inteiros, de 5 a 15; o padrão é 8. Sua origem é somada à frente e não é cobrada. |
resolution | Não | Resolução do novo segmento: 480p ou 768p, padrão 768p. Ambas são renderizações nativas. |
enable_prompt_expansion | Não | Desativado por padrão, então o prompt é usado exatamente como você o escreveu. Valor padrão: |
video_url | Sim | O clipe a ser continuado: MP4, MOV ou WebM, de até 60 segundos. O último quadro vira o quadro inicial do novo segmento, então corte em um quadro limpo e nítido. pelo menos 1 caracteres |
Preços
A cobrança é por segundo do novo segmento, na resolução que você escolher; o clipe de origem que você envia não é cobrado. Uma geração que falha, ou uma união que não pode ser construída, é reembolsada integralmente. Ativar a expansão do prompt adiciona uma taxa fixa por requisição.
| Especificação | Preço |
|---|---|
| $0.05 / segundo |
| $0.08 / segundo |
Casos de uso
Plano principal a partir de um quadro aprovado
Com a cena fechada, gere primeiro o frame inicial e envie para o image-to-video: o figurino, o corpo e o rosto que você desenhou chegam intactos em vez de serem reinventados a cada execução.
Filme de campanha anamórfico
21:9 com uma caminhada lenta em direção à câmera, luz de recorte dura e uma máquina de vento: a gramática de fashion film em que a faixa é boa. Uma requisição de 15 segundos cobre uma aproximação e parada completa, então não sobra emenda para esconder na edição.
Versão vertical saindo do mesmo briefing
O mesmo plano escrito roda de novo em 9:16 para feeds e em 1:1 para espaços quadrados. Mantenha o prompt e a duração e mude só a proporção para ver como o reenquadramento funciona antes de produzir o conjunto completo de entregas.
Clipe que precisa encaixar na montagem
Quando um plano tem de começar num quadro de board e terminar noutro, forneça os dois como image_url e last_image_url. O movimento gerado aterrissa na composição de fechamento, então o quadro de saída bate com o próximo plano da timeline.
Guia de prompt e dicas práticas
Escolha entre texto e primeiro quadro
Uma ideia escrita vai para o text-to-video; um still aprovado vai para o image-to-video, que o segue de forma muito mais literal. Os dois endpoints não compartilham conjunto de campos — o image-to-video não tem
aspect_ratio, porque o quadro de abertura decide o formato.Escreva o plano e depois defina o formato
Descreva sujeito, movimento, luz e som na ordem em que acontecem, e defina
aspect_ratiovocê mesmo, porque o padrão é 1:1. Um briefing que funciona é assim: "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."Itere com uma mudança por vez
Mude uma coisa por execução, para que cada resultado reflita só o que você editou, e escreva no prompt os detalhes que importam em vez de deixar lacunas para o modelo preencher. O som é gerado com a imagem, então qualquer indicação de trilha ou ambiência vai no mesmo prompt.
Introdução
MiniMax H3 Max Extensão de vídeo continua um clipe que você já tem. Envie-o como video_url com um prompt do que acontece depois. O último quadro do clipe vira o quadro inicial de um novo plano de image-to-video do MiniMax H3 Max de 5 a 15 segundos, e os dois são unidos em um único MP4: primeiro o seu original, depois a continuação, sem o quadro repetido da emenda. O novo segmento também volta como arquivo próprio, para você continuar estendendo ou editar as partes separadamente.
Principais recursos e destaques
A continuidade vem do último quadro
Figurino, cenário, luz e a posição de cada pessoa se mantêm, porque o novo segmento começa literalmente no seu último quadro. O movimento não se transfere do mesmo jeito: o modelo vê uma imagem parada, não o clipe inteiro, então descreva o movimento que você quer continuar em vez de presumir que ele manterá a velocidade ou a direção.
Um arquivo de volta, mais a parte nova sozinha
O MP4 unido mantém a taxa de quadros e o enquadramento do seu clipe, sem faixas pretas. Para alinhar a emenda, a imagem pode ser cortada ou ajustada em poucos pontos percentuais nas bordas. Se o modelo devolver uma proporção bem diferente, o novo segmento é redimensionado para preencher o seu quadro, centralizado, e o que sobra é cortado. O novo segmento vem com som gerado na mesma passada; o som da sua origem permanece, e a emenda é misturada em uma fração de segundo. Se um lado é mudo, o outro é completado com silêncio. O segundo recurso da saída é só o novo segmento, com o papel segment, pronto para outra extensão ou para um editor.
Um quadro final opcional
last_image_url é opcional. Envie uma imagem e o novo segmento termina nela; se omitir, o final é livre. O quadro final só aperta o desfecho, e quanto mais longo o segmento, mais o meio pode se afastar dele.
Todo o resto é image-to-video do MiniMax H3 Max
O novo segmento roda nas mesmas rotas, com o mesmo intervalo de conteúdo e o mesmo preço por segundo do endpoint de image-to-video, e uma geração que falha é reembolsada do mesmo jeito. Se a geração der certo mas a união não puder ser construída, a tarefa falha e a cobrança é reembolsada.
Casos de uso
Alongar um plano que terminou cedo demais
Um prato giratório de produto que para antes de o rótulo ficar de frente para a câmera, ou uma caminhada cortada antes de o personagem chegar à porta. Estenda por alguns segundos e descreva só o movimento que falta.
Construir uma sequência mais longa passo a passo
Uma requisição gera no máximo 15 segundos. Para ir além, gere um primeiro plano, estenda e depois estenda de novo o resultado unido; cada passo cobra apenas os segundos que adiciona. Como cada passo parte de um único quadro, confira cada emenda antes de empilhar a próxima.
Guia de prompts e dicas profissionais
Descreva o próximo tempo, não a cena inteira
O quadro já fixa quem e onde, então use o prompt para a ação que segue, o movimento de câmera e o som. Repita a linguagem de câmera em que o clipe terminou, como um avanço lento ou um plano fixo, para a emenda parecer uma única tomada.
Corte antes de estender
O último quadro é a única coisa que o modelo vê, então um final borrado, cortado no meio do movimento ou muito comprimido passa direto para a continuação. Corte primeiro a origem em um quadro limpo e nítido. Origens de até 60 segundos são aceitas em MP4, MOV ou WebM.
Mantenha a resolução coerente
A resolução define apenas a nitidez com que o novo segmento é gerado, então uma configuração menor deixa a parte nova mais suave que o original. Combine a resolução com a da origem e defina duration_seconds com a duração de que você realmente precisa: a cobrança acompanha apenas o novo segmento.
Início rápido da 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"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.
