Introdução
O MiniMax H3 Spicy imagem para vídeo anima um quadro inicial sem censura, com quadro final opcional e orientação de movimento opcional.
O MiniMax H3 Spicy é uma versão do MiniMax H3 ajustada para adultos, publicada como endpoints de imagem para vídeo e de video-extend; esta página trata o de imagem para vídeo. O quadro inicial que você envia define o sujeito, um quadro final opcional define o fechamento e o prompt conduz os 3 a 15 segundos entre eles, em 480p, 540p, 768p ou 1080p.
Recursos e destaques
Seu quadro decide o conteúdo, não um filtro de texto
Como a única entrada é um quadro inicial, esta família não tem a distância de sempre entre o que você pediu e o que um prompt de texto aceita gerar. O que está na imagem, ou seja, figurino, corpo, pose e enquadramento, é o que ganha movimento. O prompt cuida, por cima disso, do movimento, da câmera e do som.
Uma imagem sozinha já é uma solicitação completa
Aqui o prompt não é obrigatório. Envie uma imagem e o modelo deduz dela um pequeno movimento plausível, muitas vezes tudo de que um loop precisa. Adicione texto quando quiser um momento específico, como um giro em direção à câmera, uma mão passando pelo cabelo ou uma mudança de expressão, e descreva apenas o que acontece, em vez de descrever o enquadramento de novo.
Combine com um modelo de imagem sem censura
O fluxo prático tem duas chamadas: gere a imagem com um modelo de imagem sem censura e depois anime aqui. Assim o problema se divide ao meio: composição e conteúdo se resolvem numa passada de imagem barata que você refaz rápido, e a passada de vídeo só precisa acertar o movimento.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
image_url | Sim | Obrigatório. O still que anima — ele decide o conteúdo, então acerte-o primeiro. |
last_image_url | Não | Opcional, e só válido com |
prompt | Não | Opcional. Descreva a cena, a câmera e o som; não redescreva o quadro. |
duration_seconds | Não | Segundos inteiros, de 3 a 15. Três sai barato o bastante para gerar variantes em massa. |
resolution | Não | 480p, 540p, 768p ou 1080p. O padrão é 480p, o mais barato dos quatro degraus. |
seed | Não | Opcional, de 0 a 2147483647. |
Preços
| Especificação | Preço |
|---|---|
| $0.038 / segundo |
| $0.057 / segundo |
| $0.084 / segundo |
| $0.152 / segundo |
Casos de uso
Cenas adultas que outras APIs recusam
Seus quadros são aceitos e animados como chegam. Clipes que APIs de vídeo hospedadas recusam no filtro de prompts rodam aqui, e como o conteúdo está no quadro e não no texto, o resultado corresponde ao que você aprovou, não a uma reinterpretação suavizada.
Clipes de companhia e roleplay
Uma imagem de personagem vira uma biblioteca de reações curtas: um olhar para cima, um sorriso, um giro de ombro, o cabelo jogado para trás. Mantenha o mesmo quadro inicial e mude só o prompt, e a personagem continua igual em todos os clipes do conjunto.
Animar um ensaio de fotos existente
Um ensaio que você já tem vira movimento sem refazer as fotos. Cada quadro vira um clipe de 3 a 15 segundos, e um quadro final permite que duas imagens do mesmo ensaio definam o começo e o fim de um movimento.
Guia de prompt e dicas práticas
Faça o quadro inicial primeiro
Resolva figurino, corpo, pose e enquadramento numa passada de imagem, porque é essa imagem que o vídeo vai conter. Um quadro que já está certo não precisa brigar com o prompt depois.
Use o quadro final para um fechamento conhecido
last_image_url só pode ser enviado junto com image_url e restringe o fechamento, não o meio. Acrescente só quando o clipe precisar chegar a uma composição conhecida, como uma segunda imagem do mesmo ensaio.
Adapte o exemplo incluído
O exemplo publicado usa duration_seconds 5 e resolution 768p, com uma única imagem como image_url.
She exhales a slow plume of smoke against the rain-streaked glass, the neon sign outside pulses red across her face, and she turns her head toward camera without changing expression. Blind shadows creep, rain runs down the window, distant traffic.
Uma imagem mais uma nota de movimento: a fumaça, o ciclo do neon e o giro de cabeça estão escritos, e tudo o que identifica a pessoa veio do quadro.
Rascunhe barato, finalize uma vez
A resolução padrão é 480p, a mais barata dos quatro níveis. Gere várias variações de três segundos em 480p, escolha uma e gere de novo em 768p ou 1080p com duração maior, mantendo o prompt e o quadro inicial idênticos para que a comparação faça sentido.
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-spicy/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"resolution": "480p"
}
}'
# 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.
