MiniMax

MiniMax H3 Max Turbo

minimax-h3-max-turbo/image-to-video

Modelo de vídeo da MiniMax com perfil de otimização de velocidade, compatível com texto para vídeo e imagem para vídeo (permite especificar o primeiro quadro e um quadro final opcional), gerando clipes de 1 a 15 segundos em 480P até 1080P por execução, ideal para produção rápida de vídeos curtos de marketing e pré-visualização de storyboards

minimax-h3-max-turbo/image-to-video minimax-h3-max-turbo/text-to-video

Experimentar minimax-h3-max-turbo/image-to-video

Entrada

Criações

Ver todas as criações

Saída

video

Preencha os parâmetros e gere — os resultados aparecerão aqui.

Preços

minimax-h3-max-turbo/image-to-video per second

Especificações	Preço unitário
480P	$0.025
768P	$0.040
1080P	$0.080

Visão geral e posicionamento

Gera um clipe de vídeo usando uma única imagem como primeiro quadro, e a tela de saída segue a proporção da imagem de entrada. Indicado para desenvolvedores que precisam transformar imagens estáticas em curtas-metragens dinâmicos, podendo ser usado para produção rápida de conteúdo para redes sociais, pré-visualização dinâmica de storyboards publicitários ou exibição animada de materiais de imagem. Permite restringir o quadro final com uma imagem de último quadro opcional e controlar o resultado por meio de prompt, duração e parâmetros de resolução.

Destaques principais

Geração de imagem guiada pelo primeiro quadro — faça upload de uma imagem como primeiro quadro; a tela de saída do vídeo mantém a proporção dessa imagem, preservando o ponto de partida da composição.
Restrição opcional de encerramento pelo último quadro — forneça adicionalmente uma imagem de quadro final para convergir o encerramento do vídeo à imagem especificada, ideal para transições ou encerramentos em quadro congelado.
Duração e resolução ajustáveis — a duração de cada geração pode ser de 1 a 15 segundos, e a resolução oferece três opções: 480P, 768P ou 1080P.
Semente controlável e reproduzível — fixe a semente aleatória pelo parâmetro seed, facilitando reproduzir ou ajustar finamente a mesma evolução de imagem em gerações em lote.

Descrição das capacidades

Vídeo a partir de imagem de primeiro quadro: especifique a imagem do primeiro quadro em image_url e combine com prompt para gerar um vídeo dinâmico; a tela de saída segue a proporção dessa imagem, ideal para converter imagens estáticas em clipes dinâmicos.

Restrição do quadro final: além do primeiro quadro, é possível passar end_image_url como quadro final, fazendo o encerramento do vídeo se aproximar da imagem especificada, para transições ou planos congelados.

Controle de duração e resolução: duration pode ser definido entre 1 e 15 segundos, e a saída real pode ficar cerca de 0,7 segundo mais longa que o solicitado; resolution oferece três opções — 480P, 768P ou 1080P —, sendo 1080P um refinamento por ampliação baseado na geração nativa em 768P.

Ajuste de expansão do prompt: prompt_expansion_mode pode ser disabled, balanced ou quality, respectivamente pulando a expansão, retornando rapidamente ou gastando cerca de 30 segundos para gerar um prompt mais rico, ajudando a controlar os detalhes da geração.

Cenários de aplicação

Animação de imagens para redes sociais — profissionais de operação usam imagens de produto ou pôsteres como primeiro quadro, com um prompt curto, para gerar rapidamente vídeos curtos dinâmicos para publicação em redes sociais ou materiais de feed.
Pré-visualização dinâmica de storyboards publicitários — equipes de pré-produção de publicidade ou audiovisual usam imagens de quadros-chave mais uma imagem de quadro final para gerar clipes de transição como pré-visualização dinâmica de storyboard, para propostas internas ou referência de filmagem.
Conversão de material de imagem em clipe de vídeo — criadores de conteúdo usam fotografias ou ilustrações como primeiro quadro para gerar curtas-metragens dinâmicos de alguns segundos, para portfólio ou planos de transição em edição de vídeo.
Produção de planos de encerramento em quadro congelado — use duas imagens, de primeiro e último quadro, para restringir o início e o fim da imagem, gerando um curta que transita do quadro inicial ao quadro final especificado, para efeitos de abertura ou encerramento congelado.

Limitações e recomendações de seleção

A imagem de primeiro quadro image_url é obrigatória; não há suporte a geração apenas com entrada de texto. A imagem de último quadro é uma restrição opcional e não garante convergência precisa da imagem a ela. Ao escolher resolution 1080P, a saída é um refinamento por ampliação baseado na geração nativa em 768P, não uma geração nativa em 1080P. duration é definido de 1 a 15 segundos, e a saída real pode ficar cerca de 0,7 segundo mais longa que o solicitado. O prompt tem no máximo 50000 caracteres e o link da imagem tem no máximo 50000 caracteres. Os resultados gerados não garantem consistência absoluta de personagens ou reprodução exata da imagem.

Novidades

Ver o changelog →

Novo modelo MiniMax H3 Max Turbo disponível: geração de vídeo a partir de texto e de imagem com primeiro e último quadro Nov 12, 2026

Perguntas frequentes

Ver todas as perguntas →

O 1080P deste modelo é gerado nativamente?

Não é geração nativa; o 1080P é obtido por refinamento no espaço latente a partir de uma fonte 768P. O nível mais alto gerado nativamente pelo modelo é 768P. Se houver requisitos rígidos quanto aos detalhes da imagem, recomenda-se avaliar com base na geração nativa em 768P, ou usar um nível que suporte master 2K.
A geração de vídeo a partir de imagem pode usar uma imagem de referência para fixar o personagem?

Atualmente não há suporte para geração de vídeo a partir de imagem de referência. O image_url serve apenas como quadro inicial, e a tela de geração seguirá essa imagem; não é possível usar imagens de referência, clipes de referência ou áudio para fixar personagem e estilo. Cenários que exigem consistência de personagem devem usar um nível que suporte geração de vídeo a partir de imagem de referência.
Como configurar o primeiro e o último frame para controlar o ponto final do enquadramento da câmera?

Use image_url para especificar o primeiro frame e o end_image_url opcional para especificar o último frame; o modelo interpola o movimento entre os dois. O primeiro frame define toda a tela de saída, portanto a composição e a proporção do último frame devem ser próximas às do primeiro, caso contrário a interpolação tende a gerar distorções.
A duração do vídeo gerado pode ultrapassar 15 segundos?

Cada geração tem no máximo 15 segundos e não é possível produzir um clipe mais longo de uma só vez. A saída real pode ficar cerca de 0,7 segundo mais longa que o duration informado. Se precisar de um vídeo final mais longo, gere em segmentos por plano e depois os concatene.

Criar uma tarefa de geração

POST https://api.hiapi.ai/v1/tasks

Cabeçalhos

AuthorizationstringObrigatório

Chave de API da conta. Obrigatória em toda requisição. Exemplo: Bearer YOUR_HIAPI_API_KEY. Obter chave de API

Content-TypestringOpcional

O corpo da requisição é sempre interpretado como JSON; se enviado, apenas application/json (charset opcional) é aceito — qualquer outro valor retorna 415. Exemplo: application/json.

Idempotency-KeystringOpcional

Chave de idempotência, até 255 bytes. Retries com a mesma chave da mesma conta criam a tarefa apenas uma vez; replays retornam o taskId original.

Chave de idempotência

Em timeouts de rede ou retries automáticos do cliente, a mesma chave cria a tarefa apenas uma vez, sem cobrança duplicada (escopo = a conta da chave de API). Use um identificador de negócio exclusivo (ex.: "order-42"); replays retornam o taskId original e as chaves expiram 24 h após a primeira requisição. A matriz completa de cenários está na introdução da API assíncrona unificada.

Corpo

modelstringObrigatório

Valor fixo atual: minimax-h3-max-turbo/image-to-video

routestringOpcional

Valor fixo atual: default

inputobjectObrigatório

Objeto de parâmetros de negócio para minimax-h3-max-turbo/image-to-video e a rota default — veja a tabela de parâmetros abaixo.

seedintegerOpcional

Semente aleatória usada para controlar a aleatoriedade do resultado gerado; se omitida, uma semente aleatória é escolhida automaticamente.

promptstringObrigatóriominLength 1maxLength 50000

Prompt de texto usado para a geração do vídeo.

durationnumberOpcionalPadrão: 5min 1max 15

Duração do vídeo em segundos, padrão de 5 segundos; a saída real pode ser até cerca de 0,7 segundo mais longa que o valor solicitado. Quando target_audio_url é fornecido, a duração deve ser de pelo menos 2 segundos.

image_urlstringObrigatóriomaxLength 50000

URL da imagem usada como primeiro quadro; a tela de saída seguirá essa imagem.

resolutionstringOpcionalPadrão: "768P"

Resolução de geração, padrão 768P; também é possível especificar 1080P, caso em que haverá refinamento no espaço latente a partir da fonte nativa 768P.

Opções:480P768P1080P

end_image_urlstringOpcional

Opcional, URL da imagem usada como último quadro.

target_audio_urlstringOpcional

Opcional, URL de um trecho de áudio para fixar à trilha sonora gerada; esse áudio deve ter pelo menos 2 segundos de duração e no máximo 15 MB.

prompt_expansion_modestringOpcionalPadrão: "balanced"

Grau de esforço investido na reformulação do prompt antes da geração, padrão balanced: disabled ignora a expansão do prompt, balanced retorna em cerca de 1 segundo, quality leva até cerca de 30 segundos para gerar prompts mais ricos.

Opções:disabledbalancedquality

callbackobjectOpcional

Configuração de notificação de estado terminal. Se omitida, sem callback: consulte a tarefa por conta própria.

Callbacks (Webhook)

Informe callback.url na criação e o HiAPI fará POST no seu serviço no estado terminal, sem polling. O corpo do callback replica a estrutura do detalhe da tarefa; assinatura, retries e idempotência estão descritos na introdução da API assíncrona unificada.

urlstringObrigatório

Obrigatória se callback estiver presente. No estado terminal é enviado um POST para esta URL; deve ser uma URL http(s) válida.

whenstringOpcionalPadrão: "final"

Atualmente só há suporte a final — notifica tanto em success quanto em fail.

Opções:final

storagestringOpcionalPadrão: "temp"

Nível de armazenamento de artefatos: temp (padrão, ~7 dias) ou persistent (longo prazo, cobrado por tamanho). Saldo insuficiente ou limite excedido ⇒ rebaixamento silencioso para temp; o nível efetivo aparece na resposta de detalhes.

Opções:temppersistent

Exemplos de requisição

# Envia uma tarefa assíncrona; retorna um taskId imediatamente (sem esperar a geração)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax-h3-max-turbo/image-to-video",
  "input": {
    "prompt": "…",
    "duration": 5,
    "image_url": "…",
    "resolution": "768P",
    "prompt_expansion_mode": "balanced"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "minimax-h3-max-turbo/image-to-video",
    input: {
      "prompt": "…",
      "duration": 5,
      "image_url": "…",
      "resolution": "768P",
      "prompt_expansion_mode": "balanced"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "minimax-h3-max-turbo/image-to-video",
        "input": {
          "prompt": "…",
          "duration": 5,
          "image_url": "…",
          "resolution": "768P",
          "prompt_expansion_mode": "balanced"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obter detalhes da tarefa

GET https://api.hiapi.ai/v1/tasks/:id

Campos da resposta

taskIdstringObrigatório

ID da tarefa, sempre com prefixo tk-hiapi-.

modelstringObrigatório

Nome completo resolvido do modelo. Tarefas enviadas com o parâmetro route retornam base@route (ex.: gpt-image-2/text-to-image@ext); caso contrário, igual ao nome enviado.

routestringOpcional

Presente apenas se o parâmetro route explícito foi usado; ecoa o valor enviado.

statusstringObrigatório

Estado da tarefa.

Valores de status

queued Na fila, ainda não iniciada. handling Em processamento. archiving Processamento concluído, preparando artefatos. success Terminal: concluído, artefatos disponíveis (retorna output). fail Terminal: falha (retorna error). Após o envio, acompanhe status: success e fail são terminais, os demais não. Faça polling a cada 1–3 s até o estado terminal. Em caso de sucesso, baixe os artefatos em output[].url e transfira antes de expireAt; para retenção longa, use storage: "persistent" na criação.

creatednumberObrigatório

Momento de criação da tarefa (segundos Unix).

completednumberObrigatório

Segundos Unix do estado terminal; 0 enquanto não terminal.

outputarrayOpcional

Presente apenas com status == success. Lista de artefatos — sempre um array; uma tarefa pode retornar vários types ao mesmo tempo (ex.: video + first_frame).

Array [ object ]

Itens do array

urlstringObrigatório

URL do artefato, baixável diretamente.

typestringObrigatório

Valores possíveis no momento: video, image, audio, first_frame, last_frame, thumbnail; poderão ser ampliados.

expireAtnumberObrigatório

Segundos Unix de disponibilidade do artefato; baixe ou transfira antes da expiração.

errorobjectOpcional

Presente apenas com status == fail.

codestringObrigatório

Código de erro de negócio.

messagestringObrigatório

Descrição do erro.

Exemplos de resposta

Sucesso

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

Em processamento (não final)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Falhou

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}