hailuo_2_3_fast, adicione opcionalmente uma imagem de primeiro quadro e, em seguida, conclua a tarefa assíncrona por polling ou callback.API Hailuo 2.3 Fast
Acesse o Hailuo 2.3 Fast através da API independente da GoEnhance. Envie um prompt com o ID de modelo exato
Criar uma Chave de API
Dois Modos de Geração, Um Endpoint
Texto para Vídeo
Envie o prompt necessário e omita a image_url. Para texto para vídeo, use ratio para solicitar o enquadramento pretendido.
Imagem para Vídeo com Primeiro Quadro
Adicione uma image_url pública como primeiro quadro. O prompt continua sendo obrigatório e deve descrever o movimento, o comportamento da câmera e a evolução da cena.
Valide as solicitações em relação ao contrato ativo da GoEnhance antes do uso em produção.
Capacidades da API Hailuo 2.3 Fast
ID de Modelo MiniMax Exato
Defina <code>model</code> como <code>hailuo_2_3_fast</code>. Tanto <code>model</code> quanto <code>prompt</code> são obrigatórios.
Entrada de Prompt ou Primeiro Quadro
Omita <code>image_url</code> para texto para vídeo, ou forneça uma URL de imagem pública para iniciar uma tarefa de imagem para vídeo.
Regras de Duração
Escolha 6 ou 10 segundos. A opção 1080P suporta apenas 6 segundos.
768P ou 1080P
Os valores de resolução documentados são <code>768P</code> e <code>1080P</code>, com 768P como padrão.
Proporção de Texto para Vídeo
O campo opcional <code>ratio</code> controla o enquadramento para solicitações de texto para vídeo.
Conclusão Assíncrona
Uma resposta de envio bem-sucedida retorna <code>data.img_uuid</code> para conclusão baseada em polling ou callback.
Custo fixo por vídeo gerado, conforme listado atualmente pela GoEnhance em $0.02 por token.
Preços da API Hailuo 2.3 Fast
768P · 6 segundos
12,35 tokens por vídeo, equivalente a $0.247.
768P · 10 segundos
20,8 tokens por vídeo, equivalente a $0.416.
1080P · 6 segundos
21,45 tokens por vídeo, equivalente a $0.429. Uma opção de 10 segundos em 1080P não está documentada.
Integre a Hailuo 2.3 Fast em três etapas
1
1. Crie a solicitação
Faça um POST para
https://api.goenhance.ai/api/v1/videos/generations com autenticação bearer, model, prompt e configurações opcionais válidas. 2
2. Salve o ID da tarefa
Verifique a resposta HTTP mais o
code e a msg JSON. Em caso de sucesso, persista o data.img_uuid. 3
3. Faça polling ou receba callbacks
Faça polling em
/api/v1/jobs/detail com o ID da tarefa ou forneça uma custom_callback_url. A entrega do callback é tentada até três vezes quando seu endpoint não retorna HTTP 200.Crie fluxos de trabalho de vídeo curto rastreáveis em torno de validação de solicitação explícita e estado assíncrono.
Casos de Uso da API Hailuo 2.3 Fast
Iteração Criativa
Coloque em fila rascunhos de 768P de menor custo antes de selecionar prompts para execuções de produção em alta resolução.
Conceitos de Movimento de Produto
Transforme fotos de produtos aprovadas em estudos de movimento guiados pelo primeiro quadro para revisão.
Variantes de Campanha
Envie prompts, durações e opções de enquadramento alternativos como trabalhos rastreáveis separados.
Previsualização de Storyboard
Gere estudos de cena curtos para direção de câmera, ritmo, iluminação e clima.
Pipelines de Conteúdo Automatizados
Conecte a geração a uma fila de backend que armazena IDs de tarefas e gerencia estados terminais.
Conceitos Verticais e Paisagem
Use o campo de proporção de texto para vídeo para definir o enquadramento necessário para cada superfície de entrega.
Respostas sobre o uso de endpoint, preços, entradas e conclusão assíncrona.