Skip to main content
POST

Autorização

string
obrigatório
Todos os endpoints da API exigem autenticação via Bearer TokenObtenha sua chave de API:Acesse a página de gerenciamento de chaves de API para obter sua chave de APIAdicione ao cabeçalho da requisição:

Parâmetros da requisição

string
obrigatório
Modelos suportados:
  • MiniMax-Hailuo-2.3 - Hailuo 2.3
  • MiniMax-Hailuo-2.3-Fast - Hailuo 2.3 Fast (menor latência)
MiniMax-Hailuo-2.3-Fast:
Com este modelo, first_frame_image é obrigatório.
boolean
padrão:"false"
Define se o conteúdo deve ser moderado antes do envio da tarefa de vídeo.
  • true: verificar prompts e imagens de entrada com omni-moderation-latest
  • false ou omitido: não enviar solicitação de moderação, sem custo nem latência adicionais de moderação (padrão)
string
obrigatório
Descrição do conteúdo do vídeo (máximo 2000 caracteres)Descreva cenas, ações e estilos em detalhes para obter melhores resultados. Suporta comandos de movimento de câmera (veja Comandos de Movimento de Câmera abaixo).Exemplo: "A cute kitten running on the grass"
integer
padrão:"6"
Duração do vídeo (segundos)Opções:
  • 6 - vídeo de 6 segundos
  • 10 - vídeo de 10 segundos
Padrão: 6
Limitação de 1080p: ao usar resolução 1080p, apenas a duração de 6 segundos é suportada
string
padrão:"768p"
Resolução do vídeoOpções:
  • 768p - alta definição
  • 1080p - Full HD (suporta apenas duração de 6 segundos)
Padrão: 768p
string
Imagem do primeiro quadro do vídeoSuporta dois formatos:
  • URL pública: https://example.com/start.jpg
  • Codificado em Base64: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
Quando fornecida, esta imagem será usada como o quadro inicial do vídeo
MiniMax-Hailuo-2.3-Fast:
Com este modelo, first_frame_image é obrigatório.
boolean
padrão:"true"
Se deve otimizar automaticamente o promptQuando ativado, o sistema otimizará automaticamente seu prompt para obter melhores resultados de geraçãoPadrão: true
boolean
padrão:"false"
Se deve reduzir o tempo de otimização do promptQuando ativado, a velocidade de processamento é mais rápida, mas a qualidade da otimização pode ser ligeiramente afetadaPadrão: false
boolean
padrão:"false"
Se deve adicionar marca d’águaPadrão: false

Combinações de resolução e duração

Comandos de movimento de câmera

Use a sintaxe [comando] no prompt para controlar os movimentos da câmera. 15 comandos são suportados: Exemplo de uso:

Resposta

integer
Código de status da resposta, 200 em caso de sucesso
array
Array de dados da resposta

Casos de uso

Caso 1: Texto para vídeo rápido

Caso 2: Vídeo 1080p de alta qualidade

Caso 3: Imagem para vídeo com primeiro quadro

Caso 4: Comandos de movimento de câmera

Caso 5: Modo de pré-tratamento rápido

Consultar resultados da tarefaA geração de vídeos é uma tarefa assíncrona que retorna um task_id no envio. Use o endpoint Obter status da tarefa para consultar o progresso e os resultados da geração.