Série Hailuo (MiniMax)

Os modelos de geração de vídeo Hailuo da MiniMax, dois no total, chamados pelo endpoint de vídeo da OfoxAI POST /v1/videos. As tarefas são executadas de forma assíncrona: ao criar a tarefa, você recebe um ID e consulta o resultado com ele.

Escolha do modelo

ResumoPara saída em 2K, use o Hailuo 3; para 480p, use o Hailuo 3 Max. Nenhum dos dois suporta 720p ou 1080p.

Modelo	Resolução (padrão)	Duração	Proporção
Hailuo 3	`768p` `2k` (`768p`)	4–15 segundos	`21:9` `16:9` `4:3` `1:1` `3:4` `9:16` `adaptive`
Hailuo 3 Max	`480p` `768p` (`768p`)	5–15 segundos	Igual ao anterior

Os dois suportam texto para vídeo, imagem para vídeo e referência de vídeo, e podem gerar uma faixa de áudio sincronizada (generate_audio tem padrão true). adaptive mantém a proporção da imagem de entrada.

IDs de modelo (copie exatamente)

Hailuo 3minimax/hailuo-3768p, 2K

Hailuo 3 Maxminimax/hailuo-3-max480p, 768p, mínimo de 5 segundos

A tabela acima corresponde ao video_attributes retornado pela Models API; se as capacidades de um modelo mudarem, prevalece o retorno da API. A cobrança é por segundo, e o custo real é o usage.video_cost no resultado da tarefa. Os preços estão na página do modelo .

Exemplos de chamada

Os exemplos abaixo mostram apenas a requisição de criação da tarefa. O fluxo completo de consulta de status e download do resultado está em Video API · Início rápido.

Texto para vídeo

Envie apenas prompt.

Terminal


curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/hailuo-3",
    "prompt": "Plano em widescreen: um carro antigo em uma estrada no deserto seguindo em direção ao pôr do sol",
    "duration": 6,
    "resolution": "768p",
    "aspect_ratio": "21:9"
  }'

Imagem para vídeo

Envie 1 first_frame em frame_images; o vídeo usa essa imagem como primeiro frame.

Terminal


curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/hailuo-3",
    "prompt": "A pessoa da imagem se vira e caminha para longe",
    "duration": 5,
    "frame_images": [
      { "type": "image_url", "image_url": { "url": "https://example.com/first.jpg" }, "frame_type": "first_frame" }
    ]
  }'

Referência de vídeo

Envie 1 vídeo em input_references como referência. Com vídeo como entrada, os segundos cobrados podem incluir a duração do vídeo de entrada.

Terminal


curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/hailuo-3",
    "prompt": "Mantenha o movimento de câmera e transforme a imagem em uma animação no estilo pintura a nanquim",
    "duration": 5,
    "input_references": [
      { "type": "video_url", "video_url": { "url": "https://example.com/source.mp4" } }
    ]
  }'

frame_images e input_references não podem ser enviados juntos; enviar ambos retorna 400 references_conflict.
Se não precisar de faixa de áudio, envie "generate_audio": false.
A descrição completa da estrutura dos campos está em Criar tarefa de vídeo.

Valores de resolução

Os níveis de resolução do Hailuo são diferentes dos de outras séries: 768p e 2k (k minúsculo). Enviar 720p ou 1080p, comuns em outras séries, retorna 400.

Erros comuns

ResumoErros de validação de parâmetros são retornados na criação; nenhuma tarefa é criada e nada é cobrado. A mensagem de erro lista os valores permitidos.

HTTP · code	Mensagem de erro original	Causa	Solução
400 `unsupported_parameter`	`resolution "1080p" not supported; allowed: [768p 2k]`	O Hailuo não suporta 1080p	No Hailuo 3, use `768p` ou `2k`
400 `unsupported_parameter`	`duration 4 out of range [5, 15]`	O mínimo do Hailuo 3 Max é 5 segundos	Use 5 segundos ou mais, ou mude para o Hailuo 3
400 `references_conflict`	`frame_images and input_references are mutually exclusive`	Os dois campos de mídia foram enviados juntos	Escolha apenas um deles
404 `model_not_found`	`model not found`	ID do modelo digitado errado	Copie o ID do modelo desta página

Os códigos de erro completos estão em Códigos de erro da Video API.

Documentação oficial

Perguntas frequentes

O Hailuo 3 suporta 1080p?

Não. As resoluções do Hailuo 3 são 768p e 2k; as do Hailuo 3 Max são 480p e 768p. Enviar 720p ou 1080p retorna 400 resolution not supported.

O Hailuo 3 Max retorna o erro duration 4 out of range [5, 15]?

Cada tarefa do Hailuo 3 Max tem no mínimo 5 e no máximo 15 segundos. Para vídeos de 4 segundos, use o Hailuo 3.

Os vídeos Hailuo suportam 21:9?

Sim. Hailuo 3 e Hailuo 3 Max suportam 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 e adaptive.