Introdução
Extensão de vídeo com o MiniMax H3. 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, 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, reference-to-video, video-extend |
| Duração | 4–15 segundos, 5–15 no text-to-video |
| Resolução | 768p, 2k |
| Proporções | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 (texto e referência) |
| Referências | Até 9 imagens |
| Áudio | Gerado com a imagem em todos os endpoints |
| Execução | Tarefa assíncrona, cobrada por segundo de saída |
Recursos e destaques
Uma tomada pronta a partir de um parágrafo
Diga quem está no quadro, o que acontece, para onde a câmera vai e o que se ouve. O H3 entrega a luz, a granulação, o movimento e uma trilha sonora combinando em um único clipe. Esta cena noir na janela são quatro frases e mais nada.
Sua imagem, em movimento
Comece por uma imagem estática e descreva só o que acontece depois. Aqui a imagem inicial era uma xícara de café no balcão; a mão, a panorâmica até a camisa e o homem acordando atrás dela vieram todos do prompt.
A mesma mulher, a mesma roupa, uma nova cena
Entregue um rosto, um figurino e um cômodo como fotos separadas e ele junta tudo em uma tomada que você nunca filmou. É assim que um personagem continua com a mesma cara de um clipe para o outro.
A trilha sonora sai junto com a imagem
Diálogo, som ambiente e música são gerados na mesma passada. O verso cantado, o reverb do clube e o burburinho da plateia neste clipe estavam todos escritos no prompt, sem uma etapa de áudio separada.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
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 |
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 |
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. |
resolution | Não | Resolução do novo segmento: 768p ou 2k, padrão 768p. Ambas são renderizações nativas. |
duration_seconds | Não | Duração do novo segmento: segundos inteiros, de 4 a 15; o padrão é 5. Um segmento de 4 segundos só está disponível em 768p, e o 2k exige pelo menos 5 segundos. |
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.
| Especificação | Preço |
|---|---|
| $0.037 / segundo |
| $0.058 / segundo |
Casos de uso
Cenas sem censura que outras APIs de vídeo recusam
As cenas que outras APIs bloqueiam passam na primeira tentativa em vez de esbarrar em um filtro de prompt. Escreva a cena para texto para vídeo, ou gere primeiro a pessoa exata e anime essa imagem quando o visual precisa ser preciso.
Clipes verticais com som para as redes
Clipes 9:16 que já vêm com áudio: um teaser de dez segundos, um loop de clima, um momento de reação. Rascunhe em 768p até o ritmo funcionar e depois gere de novo a melhor tomada em 2K.
Um personagem recorrente ao longo de uma série
Mantenha um rosto, um figurino e um cômodo estáveis de episódio a episódio com fotos de referência, e escreva só o que muda em cada nova tomada.
Cenas mais longas, uma tomada por vez
Encadeie clipes de 15 segundos em uma cena completa: a última imagem de cada clipe aprovado vira a primeira do próximo, então figurino, cenário e luz atravessam o corte.
Guia de prompt e dicas práticas
Teste no playground
Escolha um modo acima (uma frase, sua própria imagem inicial ou algumas fotos de referência), cole um dos prompts desta página e rode. O preço exato aparece antes de qualquer cobrança.
Pegue uma chave de API
Crie sua conta, recarregue com cartão ou cripto e gere uma chave no console. Não há assinatura: você paga pelos segundos de vídeo que gerar.
Envie a mesma solicitação pelo seu código
Copie a solicitação da aba API: é o mesmo corpo que o playground acabou de rodar. O clipe pronto chega ao seu webhook, ou você o busca pelo ID da tarefa.
Introdução
MiniMax H3 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 de 4 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. Um segmento de 4 segundos só está disponível em 768p, e o 2k exige pelo menos 5 segundos.
Todo o resto é image-to-video do MiniMax H3
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/video-extend",
"input": {
"duration_seconds": 5,
"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.













