Introdução
A API MiniMax H3 X combina uma versão ajustada de H3 com controle de quadros e referências multimodais, a partir de $0.022/s na SpicyAPI; não é um lançamento oficial da MiniMax.
Uma cena H3 X aceita até 9 imagens, 2 vídeos que somem 15 segundos e 3 clipes de áudio; use Image 1, Video 1 e Audio 1 para definir suas funções. Para uma cena de produto H3 X, atribua retrato, roupa e espaço a imagens distintas e descreva como interagem.
Para uma sequência H3 X, você escolhe de 2 a 15 segundos inteiros, com 5 por padrão e saída a 24 fps. H3 X oferece 480p, 720p padrão e 1080p; os recortes da SpicyAPI não mostraram ganho visível de detalhe no arquivo de 1920 x 1088. H3 X oferece para texto e referências 16:9 padrão, 9:16, 1:1, 4:3, 3:4 e 21:9; com imagem inicial, o enquadramento vem do quadro. H3 X entrega H.264 MP4 com estéreo AAC; escreva as falas entre aspas duplas e descreva os sons do ambiente separadamente.
Os três endpoints H3 X são classificados como vídeo NSFW sem censura; a SpicyAPI não registrou recusas, embora algumas saídas de texto ou quadro inicial tenham suavizado o pedido. Para H3 X, obtenha autorização das pessoas cuja aparência ou voz você utiliza e represente apenas adultos.
Em H3 X, a ordem define Image 1 a Image 9; separe identidade, figurino e cenário, lembrando que só as primeiras 5 imagens entram no valor base. H3 X pode aproveitar movimentos de até 2 vídeos com 15 segundos combinados; essa duração é cobrada como a duração da saída. Até 3 referências de áudio podem guiar a voz H3 X; o arquivo fornece o timbre, o prompt fornece as palavras e não há adicional pela referência de áudio. H3 X é cobrado pelos segundos gerados e pela resolução; somam-se os segundos de vídeo de referência, 5 imagens estão incluídas, as demais têm custo e o áudio de referência é gratuito.
Nos testes H3 X com referências da SpicyAPI, foram entregues 5 de 5 pedidos com personagens masculinos; a categoria de teste Very strong foi alcançada em 6 de 8.
| Campo | Valor |
|---|---|
| Entrada | Texto |
| Saída | Vídeo |
| Publicador | SpicyAPI / MiniMax H3 X |
| Modelo | MiniMax H3 X |
| Lançamento | 26 de outubro de 2026 |
| Endpoints | MiniMax H3 X — Texto para vídeo / Imagem para vídeo / Referências para vídeo |
| Duração | Para uma sequência H3 X, você escolhe de 2 a 15 segundos inteiros, com 5 por padrão e saída a 24 fps. |
| Resolução | 480p, 720p (padrão), 1080p |
| Proporção | H3 X oferece para texto e referências 16:9 padrão, 9:16, 1:1, 4:3, 3:4 e 21:9; com imagem inicial, o enquadramento vem do quadro. |
| Tamanho do prompt | 1 a 7.000 caracteres |
| Referências | Uma cena H3 X aceita até 9 imagens, 2 vídeos que somem 15 segundos e 3 clipes de áudio; use Image 1, Video 1 e Audio 1 para definir suas funções. |
| Política de conteúdo | Os três endpoints H3 X são classificados como vídeo NSFW sem censura; a SpicyAPI não registrou recusas, embora algumas saídas de texto ou quadro inicial tenham suavizado o pedido. |
| Execução | H3 X é cobrado pelos segundos gerados e pela resolução; somam-se os segundos de vídeo de referência, 5 imagens estão incluídas, as demais têm custo e o áudio de referência é gratuito. |
Recursos e destaques
Uma fala citada na chuva
Um casal dança um tango lento em um terraço encharcado de chuva. Ele a inclina para trás e, em close, ela o puxa de volta pela gola da camisa e diz "Not yet." O prompt também lista a chuva, o trânsito e o bandoneon. No clipe, a fala é ouvida sobre uma música lenta e melancólica. As falas citadas foram pronunciadas palavra por palavra nas nossas verificações com reconhecimento de fala.
Três planos em um clipe de 12 segundos
Um único prompt lista três planos com horários de início: uma caminhada em plano aberto por um corredor, uma mão girando uma chave na fechadura aos 4 segundos e um plano médio dentro do quarto aos 8 segundos. No clipe, os cortes caíram em cerca de 3,9 e 8,3 segundos, com a mesma mulher do começo ao fim.
Um quadro que sussurra
Uma mulher de cabelo escuro ondulado, com um vestido de veludo preto atrás de um balcão de nogueira, entra como quadro inicial. O prompt diz só o que vem depois: ela pousa a taça, se inclina para a câmera e diz "Last call." O clipe tem uma música suave por baixo da fala.
Três referências, uma cena
Um retrato, uma foto de produto de um trench coat e um provador vazio entram como Image 1, 2 e 3. O prompt os chama pela posição e pede uma única cena com os três. No clipe, o rosto, a roupa, o casaco e o ambiente batem com as referências.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | H3 X exige um prompt de 1 a 7.000 caracteres para ação, câmera e som; coloque as falas entre aspas duplas. pelo menos 1 caracteres · no máximo 7000 caracteres |
reference_image_urls | Não | Em H3 X, a ordem define Image 1 a Image 9; separe identidade, figurino e cenário, lembrando que só as primeiras 5 imagens entram no valor base. pelo menos 1 itens · no máximo 9 itens |
reference_video_urls | Não | H3 X pode aproveitar movimentos de até 2 vídeos com 15 segundos combinados; essa duração é cobrada como a duração da saída. pelo menos 1 itens · no máximo 2 itens |
reference_audio_urls | Não | Até 3 referências de áudio podem guiar a voz H3 X; o arquivo fornece o timbre, o prompt fornece as palavras e não há adicional pela referência de áudio. pelo menos 1 itens · no máximo 3 itens |
aspect_ratio | Não | H3 X oferece para texto e referências 16:9 padrão, 9:16, 1:1, 4:3, 3:4 e 21:9; com imagem inicial, o enquadramento vem do quadro. |
resolution | Não | H3 X oferece 480p, 720p padrão e 1080p; os recortes da SpicyAPI não mostraram ganho visível de detalhe no arquivo de 1920 x 1088. |
duration_seconds | Não | Para uma sequência H3 X, você escolhe de 2 a 15 segundos inteiros, com 5 por padrão e saída a 24 fps. |
enable_prompt_expansion | Não | A expansão de prompt H3 X vem desativada; ao ativá-la, as instruções são reescritas antes da geração sem alterar o preço. Valor padrão: |
Preços
H3 X é cobrado pelos segundos gerados e pela resolução; somam-se os segundos de vídeo de referência, 5 imagens estão incluídas, as demais têm custo e o áudio de referência é gratuito.
| Especificação | Preço |
|---|---|
| $0.022 / segundo |
| $0.032 / segundo |
| $0.045 / segundo |
Casos de uso
Cenas de diálogo
Um plano falado H3 X pode unir um olhar para a câmera a uma fala curta entre aspas e ao som do ambiente.
Sequências com vários planos
Em H3 X, reserve tempo para cada plano e repita a descrição da pessoa nas mudanças de ângulo da câmera.
Filmes de moda, produto e locação
Para uma cena de produto H3 X, atribua retrato, roupa e espaço a imagens distintas e descreva como interagem.
Cópia de movimento
H3 X pode aproveitar movimentos de até 2 vídeos com 15 segundos combinados; essa duração é cobrada como a duração da saída.
Aplicativos sem filtro de conteúdo
Para H3 X, obtenha autorização das pessoas cuja aparência ou voz você utiliza e represente apenas adultos.
Guia de prompt e dicas práticas
Coloque as falas entre aspas duplas
Um plano falado H3 X pode unir um olhar para a câmera a uma fala curta entre aspas e ao som do ambiente.
Marque o tempo dos planos
Em H3 X, reserve tempo para cada plano e repita a descrição da pessoa nas mudanças de ângulo da câmera.
Nomeie as referências por tipo e posição
Uma cena H3 X aceita até 9 imagens, 2 vídeos que somem 15 segundos e 3 clipes de áudio; use Image 1, Video 1 e Audio 1 para definir suas funções.
Limites observados
Para H3 X, obtenha autorização das pessoas cuja aparência ou voz você utiliza e represente apenas adultos.
Direção de cena
Em uma cena H3 X por imagem, concentre o prompt no gesto, movimento de câmera ou resposta que ocorre depois do quadro enviado.
MiniMax H3 X
A API MiniMax H3 X combina uma versão ajustada de H3 com controle de quadros e referências multimodais, a partir de $0.022/s na SpicyAPI; não é um lançamento oficial da MiniMax.
Direção de cena
Uma cena H3 X aceita até 9 imagens, 2 vídeos que somem 15 segundos e 3 clipes de áudio; use Image 1, Video 1 e Audio 1 para definir suas funções. Para uma cena de produto H3 X, atribua retrato, roupa e espaço a imagens distintas e descreva como interagem. Um plano falado H3 X pode unir um olhar para a câmera a uma fala curta entre aspas e ao som do ambiente.
Saída e som
Para uma sequência H3 X, você escolhe de 2 a 15 segundos inteiros, com 5 por padrão e saída a 24 fps. H3 X oferece 480p, 720p padrão e 1080p; os recortes da SpicyAPI não mostraram ganho visível de detalhe no arquivo de 1920 x 1088. H3 X entrega H.264 MP4 com estéreo AAC; escreva as falas entre aspas duplas e descreva os sons do ambiente separadamente.
Cobrança
H3 X é cobrado pelos segundos gerados e pela resolução; somam-se os segundos de vídeo de referência, 5 imagens estão incluídas, as demais têm custo e o áudio de referência é gratuito.
Limites observados
Os três endpoints H3 X são classificados como vídeo NSFW sem censura; a SpicyAPI não registrou recusas, embora algumas saídas de texto ou quadro inicial tenham suavizado o pedido. Para H3 X, obtenha autorização das pessoas cuja aparência ou voz você utiliza e represente apenas adultos.
| só uma ideia | MiniMax H3 X Texto para vídeo | | um quadro para animar, com um quadro final opcional | MiniMax H3 X Imagem para vídeo | | pessoas, roupas, lugares, clipes de movimento ou vozes | MiniMax H3 X Referência para vídeo |
Nos testes H3 X com referências da SpicyAPI, foram entregues 5 de 5 pedidos com personagens masculinos; a categoria de teste Very strong foi alcançada em 6 de 8.
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-x/reference-to-video",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"reference_image_urls": [
"https://example.com/reference.png"
]
}
}'
# 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.
























