img_uuid e então faça polling do job assíncrono ou lide com as atualizações de status por meio de um callback. A GoEnhance fornece acesso de terceiros e não é a MiniMax nem uma API oficial da MiniMax.API Hailuo 2.3 para texto e imagem para vídeo
Acesse o Hailuo 2.3 por meio da API independente da GoEnhance. Envie um prompt de texto ou adicione uma imagem de primeiro quadro, receba um
Criar uma API Key
Escolha o modo de geração do Hailuo 2.3
Texto para vídeo com hailuo_2_3
Envie model: hailuo_2_3 com um prompt obrigatório. Para solicitações somente de texto, o campo opcional ratio define a proporção de aspecto da saída. Escolha 768P para 6 ou 10 segundos, ou 1080P para um resultado de 6 segundos.
Imagem para vídeo a partir de um primeiro quadro
Adicione um image_url HTTPS para usar esse ativo como o primeiro quadro. O mesmo endpoint e o mesmo ID do modelo processam a solicitação, portanto uma única integração pode suportar fluxos de trabalho somente com prompt e com primeiro quadro.
Valide modo, duração e resolução em conjunto antes de enviar uma solicitação de geração.
Parâmetros e validação da API Hailuo 2.3
Modelo e prompt
Defina <code>model</code> como <code>hailuo_2_3</code>. Um <code>prompt</code> de texto descrevendo o vídeo é obrigatório em todas as solicitações.
Imagem opcional de primeiro quadro
Forneça <code>image_url</code> para executar imagem para vídeo. Omita-o para texto para vídeo. O valor deve ser uma URL de imagem válida e acessível pelo serviço.
Regras de duração
O campo <code>duration</code> aceita 6 ou 10 segundos e o padrão é 6. Uma solicitação 1080P suporta apenas 6 segundos.
Opções de resolução
Escolha <code>768P</code> ou <code>1080P</code>; o padrão é 768P. A opção de 10 segundos está disponível apenas em 768P.
Proporção de texto para vídeo
Use o campo <code>ratio</code> opcional para solicitações de texto para vídeo. Não dependa dele como substituição da imagem de primeiro quadro.
Conclusão assíncrona
Um envio bem-sucedido retorna <code>img_uuid</code>. Faça polling em <code>GET /api/v1/jobs/detail</code> ou forneça <code>custom_callback_url</code> para atualizações de status.
A GoEnhance lista o preço por vídeo em $0.02 por token. Escolha um par válido de resolução e duração antes do envio.
Preços da API Hailuo 2.3
768P, 6 segundos — 18,2 tokens ($0.364)
Este é o menor preço listado da API Hailuo 2.3 para uma solicitação de vídeo completa.
768P, 10 segundos — 36,4 tokens ($0.728)
Use este nível quando o aplicativo precisar da duração suportada mais longa em 768P.
1080P, 6 segundos — 31,85 tokens ($0.637)
O Hailuo 2.3 suporta 1080P em 6 segundos; solicitações de 10 segundos em 1080P não são suportadas.
Integre a API do Hailuo 2.3
1
1. Crie uma chave e construa a solicitação
Crie uma chave de API, mantenha-a no seu servidor e envie autenticação bearer. Faça POST para
https://api.goenhance.ai/api/v1/videos/generations com model: hailuo_2_3, um prompt, uma duração válida e uma resolução válida. 2
2. Salve o img_uuid retornado
Trate o envio e a geração como etapas separadas. Persista o
img_uuid retornado junto com seu próprio registro de tarefa para que novas tentativas e sessões de usuário não percam a identidade da tarefa. 3
3. Consulte ou processe callbacks
Consulte
GET /api/v1/jobs/detail ou forneça uma URL pública de callback HTTPS. A GoEnhance envia mudanças de status e repete até três vezes um callback que não retorne 200, com timeout de três segundos por tentativa.Use a API quando o envio repetível e a entrega assíncrona importarem mais do que um editor manual.
O que os desenvolvedores criam com o Hailuo 2.3
Conceitos de anúncios automatizados
Transforme prompts de campanha aprovados em candidatos a vídeos curtos e encaminhe cada ativo concluído para uma fila de revisão.
Animação de imagens de produto
Use uma imagem estática do produto como primeiro quadro para criar clipes com movimento para fluxos de catálogo, lançamento ou apresentação.
Pipelines editoriais e sociais
Conecte prompts estruturados, acompanhamento assíncrono de tarefas, callbacks, moderação e armazenamento para produção repetível de vídeos curtos.
Respostas sobre entradas do modelo, preços da API do Hailuo 2.3, tarefas assíncronas, callbacks e posicionamento da API da MiniMax.