Skip to main content
POST

Autorização

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

Parâmetros da requisição

string
obrigatório
Nome do modelo de geração de vídeoValor fixo: MiniMax-Hailuo-02
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ídeoDescreva a cena, ações, estilo etc. em detalhes para obter melhores resultados de geraçãoExemplo: "A cute cat running on the grass"
integer
padrão:"5"
Duração do vídeo (segundos)Opções:
  • 5 — vídeo de 5 segundos
  • 10 — vídeo de 10 segundos
Padrão: 5
Limitação 1080p: ao usar a resolução 1080p, apenas a duração de 5 segundos é suportada
string
padrão:"768p"
Resolução do vídeoOpções:
  • 512p — definição padrão
  • 768p — alta definição
  • 1080p — Full HD (suporta apenas duração de 5 segundos)
Padrão: 768p
boolean
padrão:"true"
Se deve otimizar o prompt automaticamenteQuando habilitado, o sistema otimiza 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 promptHabilitar isso pode acelerar o processamento, mas pode afetar levemente a qualidade da otimizaçãoPadrão: false
boolean
padrão:"false"
Se deve adicionar marca d’águaPadrão: false
string
Imagem do primeiro frame do vídeoSuporta dois formatos:
  • URL pública: https://example.com/start.jpg
  • Codificada em Base64: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
Usada para especificar o frame inicial do vídeo
string
Imagem do último frame do vídeoSuporta dois formatos:
  • URL pública: https://example.com/end.jpg
  • Codificada em Base64: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
Usada para especificar o frame final do vídeo

Limitações dos parâmetros

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

Resposta

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

Casos de uso

Caso 1: Geração rápida de texto-para-vídeo

Caso 2: Gerar vídeo 1080p de alta qualidade

Caso 3: Gerar vídeo a partir da imagem do primeiro frame

Caso 4: Vídeo de transição com controle de primeiro e último frame

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

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