Introdução
A API de texto para vídeo do MiniMax H3 Lite gera clipes com som de 4 a 15 segundos em 480p ou 768p. Escreva a cena uma vez e rode de novo mudando um detalhe por vez para ver qual versão funciona. Seu design leve é adequado para testar ideias e produzir várias versões. Cada solicitação gera um único MP4 em que imagem e som saem juntos.
Escolha um modo pelo material de partida
| Seu ponto de partida | Modo a abrir |
|---|---|
| apenas uma ideia | MiniMax H3 Lite Texto para vídeo |
| um quadro para animar, com um quadro final opcional | MiniMax H3 Lite Imagem para vídeo |
| pessoas, figurinos, lugares, clipes de movimento ou vozes | MiniMax H3 Lite Referência para vídeo |
Recursos e destaques
Som e diálogo em uma só passagem
Todo clipe do MiniMax H3 Lite volta com som. Coloque as falas entre aspas duplas e descreva a música ou o ambiente com palavras; os dois chegam com o clipe, então um rascunho rápido não precisa de uma etapa de áudio à parte.
Seis proporções
As seis proporções custam o mesmo, então uma ideia pode ser testada em corte horizontal e em corte vertical sem diferença de preço.
Dois preços
480p custa cerca de 40% menos por segundo do que 768p, o que o torna a forma barata de explorar um prompt antes de renderizar a tomada final.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Obrigatório, até 7,000 caracteres; um maior que isso é rejeitado. Coloque as falas entre aspas duplas. pelo menos 1 caracteres · no máximo 7000 caracteres |
aspect_ratio | Não | Um destes: 16:9 (o padrão), 9:16, 1:1, 4:3, 3:4 ou 21:9. Não altera o preço. |
resolution | Não |
|
duration_seconds | Não | Número inteiro de segundos, entre 4 e 15, com 5 por padrão. Cobrado por segundo junto com a resolução. |
Preços
Cada segundo de saída é cobrado pela tarifa da resolução escolhida, 480p ou 768p. A tarifa atual sempre aparece na página do modelo.
| Especificação | Preço |
|---|---|
| $0.025 / segundo |
| $0.04 / segundo |
Casos de uso
Storyboards e clipes de apresentação
Transforme uma lista de tomadas escrita em prévias em movimento aproximadas antes de se comprometer com uma produção. Cada prompt no MiniMax H3 Lite devolve um clipe pronto com som, então a sala ouve a cena além de vê-la, e uma ideia fraca pode ser descartada antes de algo caro ser feito.
Rascunhos de prompt em volume
Roteiristas e desenvolvedores de apps podem testar muitas versões de uma cena no MiniMax H3 Lite e manter a que funciona, pagando apenas por segundo de saída. Se você muda uma só coisa por execução, seja a câmera, o figurino ou uma fala, o lote mostra qual versão merece um render mais nítido.
Clipes verticais com uma fala
Uma cena 9:16 de 5 a 8 segundos com uma fala entre aspas e ambiente se encaixa diretamente em formatos sociais com o MiniMax H3 Lite, sem uma etapa de edição para o som. Se você posta com frequência, deixe um cenário fixo e varie só a ação e a fala; assim cada rascunho de 4 segundos em 480p custa $0.10.
Guia de prompt e dicas práticas
Escreva a cena em ordem
Descreva quem está ali, o que faz primeiro e depois, onde fica a câmera, e termine com uma linha Audio: para o som. Uma ordem clara se lê melhor do que um monte de adjetivos, e nomear a luz, hora dourada ou neon por exemplo, define o clima de imediato.
Mantenha a fala curta
Uma ou duas falas entre aspas combinam com um clipe de 5 a 8 segundos; diga quem fala cada linha para que a pessoa certa mexa os lábios. Discursos longos saem apressados ou cortados, então distribua-os por vários clipes.
Rascunhe barato, finalize com capricho
Itere em 480p e renderize a versão final em 768p com o mesmo prompt; a composição se mantém bem próxima.
Cada segundo de saída é cobrado pela tarifa da resolução escolhida, 480p ou 768p. A tarifa atual sempre aparece na página do modelo.
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-lite/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "768p",
"aspect_ratio": "16:9",
"duration_seconds": 5
}
}'
# 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.
