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:

Modos de geração

O MiniMax-H3 roteia automaticamente para o modo correspondente com base nos campos da requisição. Você não precisa de um campo mode:
Exclusão mútua estrita: os campos de imagem para vídeo (first_frame_image / last_frame_image, e first_frame / last_frame em image_with_roles) não podem ser combinados com os campos de referência multimodal (image_urls, video_urls, audio_urls, e reference_image em image_with_roles). Misturá-los retorna 400.
Áudio sozinho não é permitido. Se você passar audio_urls, também deve fornecer pelo menos uma imagem de referência ou um vídeo de referência.

Parâmetros da requisição

Campos gerais

string
obrigatório
Valor fixo: MiniMax-H3
model é obrigatório e deve ser enviado explicitamente. Clientes já integrados ao Hailuo podem migrar definindo model como MiniMax-H3.
string
obrigatório
Descrição do conteúdo do vídeo. Obrigatório e não vazio em todos os cenários, máximo de 7000 caracteres por requisição.Descreva cena, sujeito, movimento e estilo em detalhes para obter melhores resultados.Exemplo: "A boy playing basketball by the sea at dusk, waves crashing, cinematic camera work"
integer
padrão:"5"
Duração de saída (segundos)
  • Intervalo: inteiro de 4 a 15
  • Padrão: 5
string
padrão:"2K"
Resolução do vídeo
  • Valor suportado: apenas 2K (padrão)
string
Proporção de tela. Você também pode passar size ou ratio com o mesmo efeito.Proporções permitidas: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16O comportamento por cenário é descrito em “Regras de proporção de tela” abaixo.
boolean
padrão:"false"
Se deve adicionar uma marca d’água AIGCPadrão: falseAlias compatível: aigc_watermark
string
URL que recebe um push quando a tarefa atinge um estado terminal (sucesso / falha)
Use webhook. Não passe o callback_url oficial. callback_url é reservado para uso interno e não é aceito de usuários.

Campos de imagem para vídeo

Para imagem para vídeo de primeiro / último quadro, especifique os papéis explicitamente. Não infira a partir da contagem de image_urls.
string
URL da imagem do primeiro quadroQuando fornecida, esta imagem é usada como o quadro inicial do vídeo.
string
URL da imagem do último quadroQuando fornecida, esta imagem é usada como o quadro final. Combine com first_frame_image para controle de primeiro+último quadro.

Campos de referência multimodal

string[]
Array de URLs de imagens de referência
Cada imagem em image_urls é tratada como uma imagem de referência (reference_image), independentemente da contagem. Elas nunca são mapeadas automaticamente para primeiro / primeiro+último quadro pela quantidade.
  • Contagem: ≤ 9
string[]
Array de URLs de vídeos de referência
  • Contagem: ≤ 3
  • Formato e limites: veja “Limites de mídia de entrada” abaixo
string[]
Array de URLs de áudio de referência
  • Contagem: ≤ 3
  • Não pode ser usado sozinho; deve ser combinado com uma imagem de referência ou um vídeo de referência

Array de imagens compartilhado (forma opcional)

object[]
Array de imagens com papéis (roles). Pode substituir first_frame_image / last_frame_image / image_urls. Cada elemento:Exemplo (primeiro + último quadro):
Exemplo (imagem de referência):

Regras de proporção de tela

Proporções concretas permitidas: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16.

Limites de mídia de entrada

Tamanho total do corpo da requisição ≤ 64 MB. Use URLs públicas para arquivos grandes; não use Base64.

Imagens

Vídeo (somente referência multimodal)

Áudio (somente referência multimodal)

Restrições de parâmetros

Violações são rejeitadas com 400 (conteúdo sensível pode retornar 422) e não são cobradas:

Resposta

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

Exemplos de requisição

Caso 1: Texto para vídeo

Caso 2: Imagem para vídeo — Primeiro quadro

Caso 3: Imagem para vídeo — Primeiro + último quadro

Caso 4: Referência multimodal para vídeo

Caso 5: Primeiro + último quadro via image_with_roles

Consultar resultados da tarefaA geração de vídeos é assíncrona e retorna um task_id no envio. Use o endpoint Obter status da tarefa para consultar o progresso e os resultados.Intervalo de polling recomendado: a cada 5 ~ 10 segundos. Timeout do cliente: 15 minutos. Em caso de sucesso, result.videos[0].url é a URL mp4. As URLs de vídeo expiram em cerca de 24 horas — salve-as prontamente. Tarefas com falha são reembolsadas automaticamente.