img_uuid retornado e, em seguida, faça o polling ou receba callbacks HTTPS para o resultado.API HappyHorse 1.1 para Geração de Vídeo
Acesse a API HappyHorse 1.1 através da API Aberta independente do GoEnhance para conversão de texto em vídeo, imagem em vídeo com primeiro quadro, ou um fluxo de trabalho separado com imagem de referência. Envie uma tarefa assíncrona, salve o
Criar uma Chave de API
Escolha o Modo de API HappyHorse Correto
Texto para Vídeo
Envie model: happyhorse-1-1 com um prompt obrigatório e sem image_url. Selecione uma proporção, duração e resolução documentadas para o vídeo gerado.
Imagem para Vídeo com Primeiro Quadro
Adicione image_url para animar um primeiro quadro. A imagem deve estar em formato JPEG, PNG ou WEBP, ter pelo menos 300px, menos de 10MB e estar dentro da faixa de proporção documentada de 1:2.5 a 2.5:1.
Vídeo com Imagem de Referência
Use model: happyhorse-1-1-ref com 1 a 9 URLs em image_urls. Refira-se a cada fonte no prompt como [Image 1], [Image 2], e assim por diante.
Valide o modo de solicitação selecionado antes de enviar trabalho para sua fila de produção.
Capacidades e Limites da API HappyHorse 1.1
Dois modos de entrada padrão
Use apenas um prompt para texto para vídeo ou adicione um <code>image_url</code> para imagem para vídeo com primeiro quadro.
Modelo de referência múltipla separado
Use <code>happyhorse-1-1-ref</code> com 1 a 9 URLs de imagem de referência obrigatórios; ele não suporta apenas texto para vídeo.
Duração de 3 a 15 segundos
Defina <code>duration</code> como um número inteiro de 3 a 15 segundos. O padrão documentado é 5 segundos.
Saída em 720p ou 1080p
Escolha <code>720p</code> ou <code>1080p</code>. O padrão documentado é <code>720p</code>.
Proporções retrato, quadrada e paisagem
A rota padrão suporta 16:9, 9:16, 1:1, 4:3 e 3:4. O modo de referência também lista 4:5 e 5:4.
Polling e callbacks
Persista o <code>img_uuid</code>, faça o polling do endpoint de detalhes do trabalho ou forneça uma URL de callback HTTPS pública para atualizações de status.
A GoEnhance documenta o preço por segundo em $0.02 por token e atualmente classifica essas taxas como uma oferta por tempo limitado.
Preços da API HappyHorse 1.1
720p: $0.104 por segundo
A geração em 720p usa 5,2 tokens por segundo. Uma solicitação de 5 segundos usa 26 tokens, ou $0.52 na conversão documentada.
1080p: $0.144 por segundo
A geração em 1080p utiliza 7,2 tokens por segundo, o que equivale a $0.144 por segundo gerado.
Estimativa por duração
Multiplique a taxa por segundo selecionada pela duração solicitada de 3 a 15 segundos. Verifique a referência da API em tempo real antes de realizar lotes de produção, pois os preços promocionais podem mudar.
Integre a API HappyHorse 1.1
1
1. Crie e proteja uma chave de API
Crie uma chave GoEnhance e envie-a como autorização bearer a partir de um código de servidor confiável.
2
2. Selecione o modelo
Escolha
happyhorse-1-1 para geração apenas por prompt ou primeiro quadro, ou happyhorse-1-1-ref para 1 a 9 imagens de referência. 3
3. Crie e valide o payload
Forneça o prompt necessário e, em seguida, valide os campos de imagem, duração, resolução, proporção e URL de callback para o modo escolhido.
4
4. Envie a tarefa de vídeo
Faça um POST para
https://api.goenhance.ai/api/v1/videos/generations e armazene o img_uuid retornado. 5
5. Acompanhe o status
Consulte
GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=... ou receba alterações de status em um callback HTTPS público. 6
6. Lide com o resultado final
Processe sucessos e falhas de forma idempotente, verifique o ativo retornado e evite trabalho duplicado a jusante quando as consultas e os callbacks se sobrepuserem.
Conecte solicitações de geração estruturadas a fluxos de trabalho de revisão, armazenamento e entrega.
Casos de uso para desenvolvedores da API HappyHorse
Variantes de vídeo de campanha
Gere conceitos de movimento curtos a partir de prompts estruturados para revisão criativa e edição posterior.
Movimento de produtos e marcas
Anime um primeiro quadro aprovado enquanto seu backend controla a duração, a resolução e o tratamento da conclusão.
Estudos de interação de personagens
Use o modelo de referência para descrever como os sujeitos de imagens de origem aprovadas devem aparecer juntos em uma cena.
Pré-visualização de storyboard
Transforme descrições de cenas em clipes revisáveis antes de se comprometer com um fluxo de produção maior.
Pipelines criativos localizados
Parametrize prompts para variantes regionais, mantendo o envio e o monitoramento de tarefas consistentes.
Filas de ativos automatizadas
Conecte a geração, a persistência do estado do trabalho, callbacks, armazenamento e aprovação humana em um serviço de backend.
Respostas sobre preços, modos de solicitação, limites de entrada e tratamento de tarefas assíncronas.