MiniMax

Hailuo 2.3

hailuo-2.3-fast/image-to-video

Modelo de geração de vídeo lançado pela MiniMax, que suporta tanto texto para vídeo quanto imagem para vídeo, com melhorias em relação à geração anterior na estabilidade do estilo anime, na renderização de movimentos de corpo inteiro e no realismo das microexpressões faciais, adequado para a criação de curtas de anime e de produções comerciais com textura realista

hailuo-2.3-fast/image-to-video hailuo-2.3/image-to-video hailuo-2.3/text-to-video

Experimentar hailuo-2.3-fast/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

hailuo-2.3-fast/image-to-video per video

Especificações	Preço unitário
6S	$0.270
10S	$0.460

Visão geral do posicionamento

Hailuo 2.3-Fast é a versão rápida da série MiniMax Hailuo 2.3 voltada para a geração de vídeo a partir de imagem. Ele recebe uma imagem de primeiro quadro e um prompt de texto, gerando vídeos de 6 ou 10 segundos, com ênfase na naturalidade dos movimentos das pessoas e das microexpressões faciais, bem como na saída estável de imagens estilizadas, como animes. É adequado para desenvolvedores que precisam testar rapidamente com uma única imagem, iterar storyboards ou produzir materiais de vídeo curto, podendo ser acessado por meio da interface unificada do HiAPI.ai.

Destaques principais

Versão leve e rápida de imagem para vídeo — a mesma série também conta com versão completa e modelo de texto para vídeo; o Fast concentra-se na eficiência de produção impulsionada por uma única imagem, sendo ideal para testes rápidos e iterações na fase inicial.
O primeiro quadro impulsiona diretamente o movimento — basta fornecer uma imagem de primeiro quadro em jpeg, png ou webp e um prompt para gerar quadros em movimento contínuo.
Otimização automática opcional de prompt — prompt_optimizer vem ativado por padrão e pode melhorar o resultado da geração sem reescrever o prompt.
Durações de 6 e 10 segundos — alternar entre as durações permite equilibrar o comprimento do material e o custo de geração, atendendo a necessidades de vídeos curtos e rascunhos de storyboard.

Descrição das capacidades

Geração de vídeo a partir de um único primeiro quadro: envie uma imagem de primeiro quadro e uma descrição textual para obter um vídeo em movimento, convertendo diretamente o material estático em um ativo de imagem reproduzível.

Controle da imagem por prompt de texto: o campo prompt aceita descrições de até 2000 caracteres, usadas para especificar ações, enquadramentos e conteúdo da imagem, controlando a direção da geração.

Duração selecionável: duration oferece duas opções, 6 e 10 segundos, permitindo que o desenvolvedor escolha o comprimento final conforme a plataforma de publicação ou a estrutura do storyboard.

Otimização automática de prompt: prompt_optimizer vem ativado por padrão e pode completar e reescrever automaticamente o prompt, reduzindo o custo de tentativa e erro na repetição de ajustes.

Cenários de aplicação

Criadores de anime e conteúdo estilizado: imagem única de personagem + prompt de animação — transforme ilustrações ou artes de personagem em clipes curtos com movimento, para curtas de anime, conteúdo para redes sociais ou pôsteres animados.
Equipes de vídeos curtos: imagem de pessoa + descrição de atuação — gere, a partir do primeiro quadro de uma pessoa, clipes com dança, movimentos corporais ou expressões faciais, como material final ou rascunho de storyboard.
Produtos e divulgação comercial: imagem de produto + roteiro de exibição — converta imagens estáticas de produtos em vídeos de exibição dinâmica, para páginas de detalhes de e-commerce, anúncios em feed ou produção rápida de curtas promocionais.
Equipes criativas: testes de visualização de roteiros — use uma única imagem para gerar rapidamente clipes de 6 ou 10 segundos e validar a direção criativa antes de decidir se avança para a produção formal.

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

Suporta apenas a geração impulsionada por uma única imagem de primeiro quadro e não oferece controle de primeiro e último quadro; a imagem de entrada deve ser jpeg, png ou webp, sem suporte a SVG. A versão Fast faz apenas imagem para vídeo, sem caminho de texto para vídeo; se for necessário gerar vídeo apenas a partir de texto ou obter a qualidade da versão completa, deve-se usar o modelo text-to-video ou a versão completa image-to-video da mesma série. A resolução e a velocidade de geração não têm parâmetros oficiais que as comprovem; recomenda-se realizar primeiro um teste em pequena escala antes de decidir a seleção.

Novidades

Ver o changelog →

Novo modelo Novo modelo disponível: hailuo-2.3-fast/image-to-video Nov 3, 2026

Perguntas frequentes

Ver todas as perguntas →

O Hailuo 2.3 Image to Video precisa de upload de imagem?

Sim. Atualmente, o hailuo-2.3/image-to-video é uma via de imagem para vídeo: a imagem de entrada é responsável pelo sujeito e pela composição inicial, e o Prompt é responsável pelas ações, pelo movimento de câmera e pelas mudanças de ambiente.
Quais durações e resoluções o Hailuo 2.3 Image to Video suporta?

O contrato de requisição atual do HiAPI suporta 6s / 10s. Os valores disponíveis estão sujeitos ao painel de parâmetros da página e à documentação da API.
Como é cobrado o Hailuo 2.3 Image to Video?

A tarefa é cobrada por vídeo, de acordo com a faixa de duração selecionada. A página exibe o preço em tempo real seguindo a unidade monetária global, e a cobrança final é baseada no registro da tarefa bem-sucedida.
Como melhorar a estabilidade do sujeito na geração de vídeo a partir de imagem?

Use uma imagem de entrada com o sujeito nítido, poucas oclusões e composição completa; no Prompt, descreva primeiro a ação principal e o enquadramento da câmera e, em seguida, liste a aparência, os materiais e as relações de fundo que devem ser preservados. Para o primeiro teste, recomenda-se usar uma duração mais curta.

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: hailuo-2.3-fast/image-to-video

routestringOpcional

Valor fixo atual: default

inputobjectObrigatório

Objeto de parâmetros de negócio para hailuo-2.3-fast/image-to-video e a rota default — veja a tabela de parâmetros abaixo.

promptstringObrigatóriominLength 1maxLength 2000

Descrição textual para geração de vídeo, usada para explicar o conteúdo da imagem que se deseja gerar. Assume valor de string.

durationstringOpcionalPadrão: "6"

Duração do vídeo gerado, em segundos. Assume valor numérico em formato de string, padrão 6.

Opções:610

image_urlstringObrigatório

URL da imagem do primeiro quadro; suporta apenas uma única imagem, nos formatos jpeg/png/webp, não suporta SVG. Assume valor de string.

prompt_optimizerbooleanOpcionalPadrão: true

Se deve otimizar automaticamente o prompt para obter melhores resultados de geração. Assume valor booleano, padrão true.

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": "hailuo-2.3-fast/image-to-video",
  "input": {
    "prompt": "…",
    "duration": "6",
    "image_url": "…",
    "prompt_optimizer": true
  }
}'

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: "hailuo-2.3-fast/image-to-video",
    input: {
      "prompt": "…",
      "duration": "6",
      "image_url": "…",
      "prompt_optimizer": true
    }
  }),
});
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": "hailuo-2.3-fast/image-to-video",
        "input": {
          "prompt": "…",
          "duration": "6",
          "image_url": "…",
          "prompt_optimizer": True
        }
    },
)
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"
    }
  }
}